org.apache.cordova.network-information

Этот плагин обеспечивает реализацию старой версии в Сети информацию о API. Он предоставляет информацию о сотовых и Wi-Fi подключение устройства, и имеет ли устройство подключения к Интернету.

Установка

cordova plugin add org.apache.cordova.network-information

Поддерживаемые платформы

• Amazon Fire ОС
• Android
• BlackBerry 10
• Обозреватель
• iOS
• Windows Phone 7 и 8
• Tizen
• Windows 8
• Firefox OS

Подключение

connectionОбъектов, через navigator.connection , предоставляет информацию о сотовых и wifi подключение устройства.

Свойства

• connection.type

Константы

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

connection.type

Это свойство предоставляет быстрый способ для определения состояния подключения устройства сети и тип подключения.

Быстрый пример

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

Изменения API

До Кордова 2.3.0 Connection был доступ к объекту через navigator.network.connection , после которого оно было изменено на navigator.connection в соответствии со спецификацией консорциума W3C. Он все еще доступен в его исходном расположении, но является устаревшим и в конечном итоге будут удалены.

iOS причуды

• iOS не может определить тип подключения к сотовой сети.
  • navigator.connection.typeимеет значение Connection.CELL для всех сотовых данных.

Windows Phone причуды

• Когда заработает в эмуляторе, всегда определяет navigator.connection.type какConnection.UNKNOWN.

• Windows Phone не может определить тип подключения к сотовой сети.

  • navigator.connection.typeимеет значение Connection.CELL для всех сотовых данных.

Причуды Tizen

• Tizen может только обнаружить Wi-Fi или сотовой связи.
  • navigator.connection.typeимеет значение Connection.CELL_2G для всех сотовых данных.

Firefox OS причуды

• Firefox OS не может определить тип подключения к сотовой сети.
  • navigator.connection.typeимеет значение Connection.CELL для всех сотовых данных.

События, связанные с сетью

offline

Событие возникает, когда приложение переходит в автономный режим, и устройство не подключено к сети Интернет.

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

Детали

offlineСобытие возникает, когда ранее подключенное устройство теряет подключение к сети, так что приложение больше не может получить доступ к Интернет. Он опирается на ту же информацию, подключение API и пожары, когда значение connection.type становитсяNONE.

Приложения обычно должны использовать document.addEventListener прикрепить прослушиватель событий после deviceready пожаров события.

Быстрый пример

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

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

iOS причуды

Во время первоначального запуска первый автономный событие (если применимо) принимает по крайней мере второй на огонь.

Windows Phone 7 причуды

Когда заработает в эмуляторе, connection.status не всегда известно, так это событие не не огонь.

Windows Phone 8 причуды

Эмулятор сообщает тип подключения как Cellular , которая не меняется, поэтому событие не не огонь.

online

Это событие возникает, когда приложение выходит в онлайн, и устройство становится подключен к Интернету.

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

Детали

onlineСобытие возникает, когда ранее несвязанных устройство получает связь сети, чтобы разрешить приложению доступ к Интернету. Он опирается на ту же информацию, подключение API и применяется при connection.type меняется от NONE в любое другое значение.

Приложения обычно должны использовать document.addEventListener прикрепить прослушиватель событий после deviceready пожаров события.

Быстрый пример

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

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

iOS причуды

Во время первоначального запуска первая online событий (если применимо) занимает по меньшей мере второе огонь, до которой connection.type являетсяUNKNOWN.

Windows Phone 7 причуды

Когда заработает в эмуляторе, connection.status не всегда известно, так это событие не не огонь.

Windows Phone 8 причуды

Эмулятор сообщает тип подключения как Cellular , который не меняется, поэтому не события не огонь.