Questa non è la versione più recente della documentazione! Click here for the latest released version.

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

La funzionalità di accesso

A partire dalla versione 3.0, Cordova implementa le API a livello di dispositivo come plugin. Utilizzare la CLI plugin comando, descritto in Command-Line Interface, aggiungere o rimuovere questa funzionalità per un progetto:

    $ cordova plugin add org.apache.cordova.network-information
    $ cordova plugin ls
    [ 'org.apache.cordova.network-information' ]
    $ cordova plugin rm org.apache.cordova.network-information

Questi comandi si applicano a tutte le piattaforme mirate, ma modificano le impostazioni di configurazione specifiche della piattaforma descritte di seguito:

Android

(in app/res/xml/config.xml)
<feature name="NetworkStatus">
    <param name="android-package" value="org.apache.cordova.NetworkManager" />
</feature>

(in app/AndroidManifest.xml)
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

BlackBerry WebWorks

(in www/plugins.xml)
<feature name="Network Status">
    <param name="blackberry-package" value="org.apache.cordova.network.Network" />
</feature>

iOS (inconfig.xml)

<feature name="NetworkStatus">
    <param name="ios-package" value="CDVConnection" />
</feature>

Windows Phone (inProperties/WPAppManifest.xml)
```
<Capabilities>
    <Capability Name="ID_CAP_NETWORKING" />
</Capabilities>
```
Riferimento: il manifesto dell'applicazione per Windows Phone
Tizen (inconfig.xml)
```
<feature name="http://tizen.org/api/systeminfo" required="true"/>
```
Riferimento: il manifesto dell'applicazione per applicazione Web Tizen

Alcune piattaforme possono supportare questa funzionalità senza richiedere alcuna configurazione speciale. Vedere Supporto piattaforma nella sezione panoramica.