tree: fa665c7c72673557045f5db4045dbd160d05969a [path history] [tgz]
  1. README.md
  2. index.md
doc/fr/README.md

cordova-plugin-network-information

Build Status

Ce plugin fournit une implémentation d‘une ancienne version de l’ API Information Network. Il fournit des informations sur l‘appareil cellulaire et connexion wifi, et si l’appareil dispose d'une connexion internet.

Installation

cordova plugin add cordova-plugin-network-information

Plates-formes supportées

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • Navigateur
  • iOS
  • Windows Phone 7 et 8
  • Paciarelli
  • Windows
  • Firefox OS

Connexion

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

Propriétés

  • connection.type

Constantes

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

connection.type

Cette propriété offre un moyen rapide pour déterminer l‘état et le type de la connexion réseau de l’appareil.

Exemple court

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

Changement d'API

Jusqu‘à Cordova 2.3.0, l’objet Connection était accessible via navigator.network.connection ; ceci a été changé pour navigator.connection afin de concorder avec la spécification du W3C. L‘accès est toujours possible à l’emplacement d'origine, mais est considéré comme obsolète et sera bientôt supprimé.

Notes au sujet d'iOS

  • iOS ne peut pas détecter le type de connexion au réseau cellulaire.
    • navigator.connection.typea la valeur Connection.CELL pour toutes les données cellulaires.

Windows Phone Quirks

  • Lors de l‘exécution dans l’émulateur, détecte toujours navigator.connection.type commeConnection.UNKNOWN.

  • Windows Phone ne peut pas détecter le type de connexion au réseau cellulaire.

    • navigator.connection.typea la valeur Connection.CELL pour toutes les données cellulaires.

Bizarreries de Windows

  • Lors de l‘exécution dans l’émulateur de téléphone 8.1, Connection.ETHERNET détecte toujours navigator.connection.type.

Bizarreries de paciarelli

  • Paciarelli ne peut détecter une connexion cellulaire ou le WiFi.
    • navigator.connection.type a la valeur Connection.CELL_2G pour toutes les données cellulaires.

Firefox OS Quirks

  • Firefox OS ne peut pas détecter le type de connexion au réseau cellulaire.
    • navigator.connection.typea la valeur Connection.CELL pour toutes les données cellulaires.

Bizarreries navigateur

  • Navigateur ne peut pas détecter le type de connexion réseau. navigator.connection.type est toujours définie sur Connection.UNKNOWN en ligne.

Événements liés au réseau

offline

L‘évènement se déclenche lorsqu’une application se déconnecte, quand l‘appareil n’est pas connecté à Internet.

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

Détails

L‘évènement offline se déclenche lorsqu’un appareil précédemment connecté perd sa connexion au réseau, empêchant ainsi l‘application d’accéder à Internet. Il s‘appuie sur les mêmes informations que l’API de connexion et se déclenche lorsque la valeur de connection.type devientNONE.

Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d‘évènements, une fois l’évènement deviceready déclenché.

Exemple court

document.addEventListener (« hors ligne », onOffline, false) ;

function onOffline() {/ / gestion de l'événement en mode hors connexion}

Notes au sujet d'iOS

Lors du démarrage initial, le déclenchement du premier évènement offline (si applicable) prend au moins une seconde.

Windows Phone 7 Quirks

Lors de l‘exécution dans l’émulateur, le connection.status est toujours inconnu, ainsi cet événement ne fait pas de feu.

Notes au sujet de Windows Phone 8

L‘émulateur signale le type de connexion comme Cellular, type qui ne change jamais, ainsi l’évènement n'est pas déclenché.

online

L‘évènement se déclenche lorsqu’une application se connecte, quand l'appareil est connecté à Internet.

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

Détails

L‘évènement online se déclenche lorsqu’un appareil précédemment non-connecté se connecte au réseau, permettant ainsi à l‘application d’accéder à Internet. Il s‘appuie sur les mêmes informations que l’API de connexion et se déclenche quand le connection.type passe de NONE à une autre valeur.

Les applications devraient en général utiliser document.addEventListener pour attacher un écouteur d‘évènements, une fois l’évènement deviceready déclenché.

Exemple court

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

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

Notes au sujet d'iOS

Lors du démarrage initial, le déclenchement du premier évènement online (si applicable) prend au moins une seconde avant quoi connection.type vaut UNKNOWN.

Windows Phone 7 Quirks

Lors de l‘exécution dans l’émulateur, le connection.status est toujours inconnu, ainsi cet événement ne fait pas de feu.

Notes au sujet de Windows Phone 8

L'émulateur signale le type de connexion comme Cellular , qui ne change pas, aussi des événements ne fait pas de feu.