<!--
# license: Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership. The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.
-->
# cordova-plugin-network-information
[](https://travis-ci.org/apache/cordova-plugin-network-information)
Questo plugin fornisce un'implementazione di una vecchia versione dell' [API di informazioni di rete](http://www.w3.org/TR/2011/WD-netinfo-api-20110607/). 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` come`Connection.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` diventa`NONE`.
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.