Connexion

L'objet connection, disponible via navigator.connection, fournit des informations sur la connection cellulaire/wifi de l'appareil.

Propriétés

Constantes

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

Accéder à la fonctionnalité

Depuis la version 3.0, Cordova implémente les API liées à l'appareil en tant que plugins. Utiliser la commande plugin de l'Interface en Ligne de Commande, décrite dans la section intitulée L'Interface en Ligne de Commande, afin d'ajouter ou retirer cette fonctionnalité à un projet :

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

Ces commandes s'appliquent à toutes les plates-formes ciblées mais modifient les paramètres de configuration spécifiques aux différentes plates-formes tel que décrit ci-dessous :

  • 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 (enconfig.xml)

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

  • Windows Phone (enProperties/WPAppManifest.xml)

    <Capabilities>
    <Capability Name="ID_CAP_NETWORKING" />
</Capabilities>

    Référence : manifeste d'Application pour Windows Phone

  • Paciarelli (dansconfig.xml)

    <feature name="http://tizen.org/api/systeminfo" required="true"/>

    Référence : manifeste d'Application pour l'Application Web paciarelli

Certaines plates-formes peuvent prendre en charge cette fonctionnalité sans nécessiter aucune configuration spéciale. Voir Support de plate-forme dans la section vue d'ensemble.