cordova-plugin-network-information
Wtyczka stanowi implementację starą wersję API informacji w sieci. Udostępnia informacje na temat urządzenia komórkowe i wifi połączenie, i czy urządzenie ma połączenie z Internetem.
Instalacja
cordova plugin add cordova-plugin-network-information
Obsługiwane platformy
- Amazon Fire OS
- Android
- BlackBerry 10
- Przeglądarka
- iOS
- Windows Phone 7 i 8
- Tizen
- Windows
- Firefox OS
Połączenie
connection
Obiektu, wystawiony przeznavigator.connection
, zawiera informacje o połączeniu urządzenia komórkowe i wifi.
Właściwości
- Connection.Type
Stałe
- Connection.UNKNOWN
- Connection.ETHERNET
- Connection.WIFI
- Connection.CELL_2G
- Connection.CELL_3G
- Connection.CELL_4G
- Connection.CELL
- Connection.NONE
Connection.Type
Oferuje szybki sposób ustalić stan połączenia sieciowego urządzenia i typ połączenia.
Szybki przykład
function checkConnection() {
var networkState = navigator.connection.type;
var states = {};
states[Connection.UNKNOWN] = 'Unknown connection';
states[Connection.ETHERNET] = 'Ethernet connection';
states[Connection.WIFI] = 'WiFi connection';
states[Connection.CELL_2G] = 'Cell 2G connection';
states[Connection.CELL_3G] = 'Cell 3G connection';
states[Connection.CELL_4G] = 'Cell 4G connection';
states[Connection.CELL] = 'Cell generic connection';
states[Connection.NONE] = 'No network connection';
alert('Connection type: ' + states[networkState]);
}
checkConnection();
Zmiana interfejsu API
Do Cordova 2.3.0 Connection
obiekt uzyskano za pośrednictwem navigator.network.connection
, po którym został zmieniony na navigator.connection
odpowiadać specyfikacji W3C. To jest nadal dostępne w jego oryginalnej lokalizacji, ale jest niezalecane i zostaną ostatecznie usunięte.
Dziwactwa iOS
- iOS nie może wykryć typ połączenia w sieci komórkowej.
-
navigator.connection.type
jest zestawConnection.CELL
dla wszystkich komórek danych.
-
Windows Phone dziwactwa
-
Po uruchomieniu w emulatorze, zawsze wykrywa
navigator.connection.type
jakoConnection.UNKNOWN
. -
Windows Phone nie może wykryć typ połączenia w sieci komórkowej.
-
navigator.connection.type
jest zestawConnection.CELL
dla wszystkich komórek danych.
-
Windows dziwactwa
- Po uruchomieniu w emulatorze telefonu 8.1, zawsze wykrywa
navigator.connection.type
jakoConnection.ETHERNET
.
Dziwactwa Tizen
- Tizen można tylko dostrzegać Wi-Fi lub połączenia komórkowe.
-
Navigator.Connection.Type
jest zestaw doConnection.CELL_2G
dla wszystkich komórek danych.
-
Firefox OS dziwactwa
- Firefox OS nie można wykryć typ połączenia w sieci komórkowej.
-
navigator.connection.type
jest zestawConnection.CELL
dla wszystkich komórek danych.
-
Quirks przeglądarki
- Przeglądarka nie może wykryć typ połączenia sieciowego.
Navigator.Connection.Type
jest zawsze zestaw doConnection.UNKNOWN
podczas online.
Zdarzenia związane z sieci
offline
Zdarzenie odpala gdy aplikacja przejdzie do trybu offline, a urządzenie nie jest podłączone do Internetu.
document.addEventListener("offline", yourCallbackFunction, false);
Szczegóły
offline
Zdarzenie fires po wcześniej podłączone urządzenie traci połączenia z siecią, dzięki czemu aplikacja może już dostęp do Internetu. Opiera się na te same informacje połączenia API i gdy odpalam wartość connection.type
staje sięNONE
.
Aplikacje zwykle należy użyć document.addEventListener
Aby dołączyć słuchacza raz deviceready
pożary zdarzenia.
Szybki przykład
document.addEventListener("offline", onOffline, false);
function onOffline() {
// Handle the offline event
}
Dziwactwa iOS
Podczas uruchamiania systemu pierwsza impreza offline (jeśli dotyczy) trwa co najmniej drugi ognia.
Dziwactwa Windows Phone 7
Po uruchomieniu w emulatorze, connection.status
zawsze jest nieznana, więc to wydarzenie nie ogień.
Windows Phone 8 dziwactwa
Emulator raporty typ połączenia, jako Cellular
, co nie zmienia, więc zdarzenie nie ogień.
online
Wydarzenie to odpala gdy aplikacja przechodzi w tryb online i urządzenie staje się połączenie z Internetem.
document.addEventListener("online", yourCallbackFunction, false);
Szczegóły
online
Zdarzenie odpala gdy wcześniej niezwiązane urządzenie odbiera połączenie sieciowe, aby umożliwić aplikacji dostęp do Internetu. Opiera się na te same informacje połączenia API i gdy odpalam connection.type
zmienia się z NONE
na inną wartość.
Aplikacje zwykle należy użyć document.addEventListener
Aby dołączyć słuchacza raz deviceready
pożary zdarzenia.
Szybki przykład
document.addEventListener("online", onOnline, false);
function onOnline() {
// Handle the online event
}
Dziwactwa iOS
Podczas uruchamiania systemu pierwszy online
zdarzenia (w stosownych przypadkach) zajmuje co najmniej drugie ognia, przed którym connection.type
jestUNKNOWN
.
Dziwactwa Windows Phone 7
Po uruchomieniu w emulatorze, connection.status
zawsze jest nieznana, więc to wydarzenie nie ogień.
Windows Phone 8 dziwactwa
Emulator sprawozdania jako typ połączenia Cellular
, które nie zmienia, więc wydarzenia czy nie ogień.