@tojestproste/caplab-network-info

Capacitor plugin (Android) zwracający pełny stan sieci: transport (WiFi/cellular/VPN/ethernet), walidację internetu, link speed, DNS, szczegóły WiFi (RSSI, pasmo, standard 802.11) i operatora komórkowego.

Część zestawu CapLab — narzędzi diagnostycznych dla Androida.

Instalacja

npm install @tojestproste/caplab-network-info
npx cap sync

Uprawnienia

Wymaga ACCESS_NETWORK_STATE i ACCESS_WIFI_STATE — obie to uprawnienia "normal", przyznawane automatycznie przy instalacji APK, bez dialogu proszącego użytkownika o zgodę. Dodawane automatycznie do AndroidManifest.xml aplikacji przy npx cap sync (manifest merger).

Uwaga o SSID: wifi.ssidRaw zawsze zwróci pusty string lub <unknown ssid>. Android od wersji 8 wymaga ACCESS_FINE_LOCATION, żeby pokazać prawdziwą nazwę sieci WiFi — to ograniczenie systemowe, nie błąd pluginu. Ten plugin celowo nie prosi o lokalizację.

Użycie

import { NetworkInfo } from '@tojestproste/caplab-network-info';

const data = await NetworkInfo.get();
console.log(data.connectionSummary); // "WiFi"
console.log(data.capabilities.internet); // true
console.log(data.wifi.rssi); // -27 (dBm)

API

• get()
• Interfaces

get()

get() => Promise<NetworkInfoResult>

Zwraca pełny stan sieci.

Returns: Promise<NetworkInfoResult>

Interfaces

NetworkInfoResult

| Prop | Type | | -------------------- | --------------------------------------------------------------------| | timestamp | number | | sdkInt | number | | hasActiveNetwork | boolean | | transport | NetworkInfoTransport | | capabilities | NetworkInfoCapabilities | | linkProperties | NetworkInfoLinkProperties | | wifi | NetworkInfoWifi | | cellular | NetworkInfoCellular | | connectionSummary | string |

Przykładowy response

Realny output (Poco X7 Pro, Android 16, WiFi 6):

{
  "connectionSummary": "WiFi",
  "capabilities": {
    "internet": true,
    "validated": true,
    "linkDownstreamKbps": 66421,
    "linkUpstreamKbps": 260421
  },
  "wifi": {
    "rssi": -27,
    "linkSpeedMbps": 2401,
    "frequencyMHz": 5500,
    "wifiStandard": 6
  }
}

Licencja

MIT