tree: 05f87c01fdfb3405be730be3bbb86ba15464d2d0 [path history] [tgz]
  1. README.md
  2. index.md
doc/it/README.md

cordova-plugin-network-information

Build Status

Questo plugin fornisce un‘implementazione di una vecchia versione dell’ API di informazioni di rete. Fornisce informazioni sul dispositivo cellulare e connessione wifi, e se il dispositivo dispone di una connessione internet.

Installazione

cordova plugin add cordova-plugin-network-information

Piattaforme supportate

  • Amazon fuoco OS
  • Android
  • BlackBerry 10
  • Browser
  • iOS
  • Windows Phone 7 e 8
  • Tizen
  • Windows
  • Firefox OS

Connessione

Il connection oggetto, esposto tramite navigator.connection , fornisce informazioni sulla connessione wifi e cellulare del dispositivo.

Proprietà

  • connection.type

Costanti

  • Connection.UNKNOWN
  • Connection.ETHERNET
  • Connection.WIFI
  • Connection.CELL_2G
  • Connection.CELL_3G
  • Connection.CELL_4G
  • Connection.CELL
  • Connection.NONE

connection.type

Questa proprietà offre un modo rapido per determinare stato della connessione di rete del dispositivo e il tipo di connessione.

Esempio rapido

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();

Cambiamento di API

Fino a Cordova 2.3.0, il Connection oggetto era accessibile tramite navigator.network.connection , dopo che è stato cambiato in navigator.connection per abbinare la specifica W3C. È ancora disponibile nella sua posizione originale, ma è obsoleto e verrà rimosso alla fine.

iOS stranezze

  • iOS non è possibile rilevare il tipo di connessione di rete cellulare.
    • navigator.connection.typeè impostata su Connection.CELL per tutti i dati cellulare.

Stranezze di Windows Phone

  • Quando è in esecuzione nell'emulatore, rileva sempre navigator.connection.type comeConnection.UNKNOWN.

  • Windows Phone non riesce a rilevare il tipo di connessione di rete cellulare.

    • navigator.connection.typeè impostata su Connection.CELL per tutti i dati cellulare.

Stranezze di Windows

  • Quando è in esecuzione nell'emulatore Phone 8.1, sempre rileva navigator.connection.type come Connection.ETHERNET.

Tizen stranezze

  • Tizen può rilevare solo un WiFi o una connessione cellulare.
    • navigator.connection.type è impostata su Connection.CELL_2G per tutti i dati cellulare.

Firefox OS stranezze

  • Sistema operativo Firefox non riesce a rilevare il tipo di connessione di rete cellulare.
    • navigator.connection.typeè impostata su Connection.CELL per tutti i dati cellulare.

Stranezze browser

  • Browser non è in grado di rilevare il tipo di connessione di rete. navigator.connection.type è sempre impostata su Connection.UNKNOWN quando si è online.

Eventi relativi alla rete

offline

L‘evento viene generato quando un’applicazione passa alla modalità offline, e il dispositivo non è connesso a Internet.

document.addEventListener("offline", yourCallbackFunction, false);

Dettagli

Il offline evento viene generato quando un dispositivo precedentemente connesso perde una connessione di rete in modo che un‘applicazione non è più possibile accedere a Internet. Esso si basa sulle stesse informazioni come l’API di connessione e viene generato quando il valore di connection.type diventaNONE.

Applicazioni in genere è necessario utilizzare document.addEventListener per fissare un listener di eventi una volta il deviceready evento incendi.

Esempio rapido

document.addEventListener("offline", onOffline, false);

function onOffline() {
    // Handle the offline event
}

iOS stranezze

Durante l'avvio iniziale, il primo evento offline (se applicabile) richiede almeno un secondo al fuoco.

Windows Phone 7 capricci

Quando è in esecuzione nell'emulatore, il connection.status è sempre sconosciuto, così fa di questo evento non fuoco.

Windows Phone 8 stranezze

L‘emulatore riporta il tipo di connessione come Cellular , che non cambia, così fa l’evento non fuoco.

online

Questo evento viene generato quando un'applicazione va online, e il dispositivo diventa collegato a Internet.

document.addEventListener("online", yourCallbackFunction, false);

Dettagli

Il online evento viene generato quando un dispositivo precedentemente scollegato riceve una connessione di rete per consentire un‘accesso di applicazione a Internet. Esso si basa sulle stesse informazioni come l’API di connessione e viene attivato quando il connection.type cambia da NONE a qualsiasi altro valore.

Applicazioni in genere è necessario utilizzare document.addEventListener per fissare un listener di eventi una volta il deviceready evento incendi.

Esempio rapido

document.addEventListener("online", onOnline, false);

function onOnline() {
    // Handle the online event
}

iOS stranezze

Durante l'avvio iniziale, il primo online evento (se applicabile) richiede almeno un secondo al fuoco, prima che connection.type èUNKNOWN.

Windows Phone 7 capricci

Quando è in esecuzione nell'emulatore, il connection.status è sempre sconosciuto, così fa di questo evento non fuoco.

Windows Phone 8 stranezze

L'emulatore riporta il tipo di connessione come Cellular , che non cambia, quindi, non gli eventi non a fuoco.