cordova-plugin-network-information

Build Status

Este plugin proporciona una implementación de una versión antigua de la Red de información API. Proporciona información acerca del dispositivo móvil y conexión wifi, y si el dispositivo tiene una conexión a internet.

Instalación

cordova plugin add cordova-plugin-network-information

Plataformas soportadas

  • Amazon fire OS
  • Android
  • BlackBerry 10
  • Explorador
  • iOS
  • Windows Phone 7 y 8
  • Tizen
  • Windows
  • Firefox OS

Connection

El objeto de connection, expuesto a través de navigator.connection, proporciona información sobre conexión celular y wifi del dispositivo.

Propiedades

  • connection.type

Constantes

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

connection.type

Esta propiedad ofrece una forma rápida de determinar el estado de conexión de red del dispositivo y el tipo de conexión.

Ejemplo rápido

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

Cambio de API

Hasta Cordova 2.3.0, el objeto de conexión era acceder a través de navigator.network.connection, tras lo cual fue cambiada a navigator.connection para que coincida con la especificación del W3C. Sigue estando disponible en su ubicación original, pero es obsoleto y eventualmente desaparecerá.

iOS rarezas

  • iOS no puede detectar el tipo de conexión de red celular.
    • navigator.connection.type está establecido en Connection.CELL para todos los datos de celulares.

Windows Phone rarezas

  • Cuando se ejecuta en el emulador, siempre detecta navigator.connection.type como Connection.UNKNOWN.

  • Windows Phone no puede detectar el tipo de conexión de red celular.

    • navigator.connection.type está establecido en Connection.CELL para todos los datos de celulares.

Windows rarezas

  • Cuando se ejecuta en el emulador de teléfono 8.1, siempre detecta navigator.connection.type comoConnection.ETHERNET.

Rarezas Tizen

  • Tizen sólo puede detectar un Wi-Fi o conexión celular.
    • navigator.connection.typese establece en Connection.CELL_2G para todos los datos celulares.

Firefox OS rarezas

  • Firefox OS no puede detectar el tipo de conexión de red celular.
    • navigator.connection.type está establecido en Connection.CELL para todos los datos de celulares.

Navegador rarezas

  • Navegador no puede detectar el tipo de conexión de red. Navigator.Connection.Type se encuentra siempre a Connection.UNKNOWN cuando en línea.

Eventos relacionados con la red

offline

El evento se desencadena cuando una aplicación está desconectada, y el dispositivo no está conectado a Internet.

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

Detalles

El evento offline se desencadena cuando un dispositivo conectado previamente pierde una conexión de red para que una aplicación no puede acceder a Internet. Se basa en la misma información que la API de conexión y cuando se dispara el valor del connection.type se convierteNONE.

Las aplicaciones normalmente deben utilizar document.addEventListener para conectar un detector de eventos una vez que se desencadene el evento deviceready.

Ejemplo rápido

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

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

iOS rarezas

Durante el arranque inicial, el primer evento offline (si es aplicable) tarda al menos un segundo en fuego.

Windows Phone 7 rarezas

Cuando se ejecuta en el emulador, la connection.status siempre es desconocido, así que este evento no se ** fuego.

Windows Phone 8 rarezas

El emulador informa el tipo de conexión como celular, que no cambia, así que el evento no se fuego.

online

Este evento se desencadena cuando una aplicación va en línea, y el dispositivo se conecta a Internet.

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

Detalles

El evento online se desencadena cuando un dispositivo previamente inconexos recibe una conexión de red para permitir un acceso a las aplicaciones para Internet. Se basa en la misma información que la API de conexión y se desencadena cuando el connection.type cambia de ninguno a cualquier otro valor.

Las aplicaciones normalmente deben utilizar document.addEventListener para conectar un detector de eventos una vez que se desencadene el evento deviceready.

Ejemplo rápido

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

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

iOS rarezas

Durante el arranque inicial, el primer evento en línea (si procede) al menos toma un segundo para disparar, antes de que connection.type es desconocido.

Windows Phone 7 rarezas

Cuando se ejecuta en el emulador, la connection.status siempre es desconocido, así que este evento no se ** fuego.

Windows Phone 8 rarezas

El emulador, informa el tipo de conexión como Cellular , que no cambia, así que se lo eventos no fuego.