Этот плагин обеспечивает реализацию старой версии API Сетевой информации. Он предоставляет информацию о сотовых и Wi-Fi подключениях устройства, и информацию имеет ли устройство подключение к Интернету.
cordova plugin add cordova-plugin-network-information
Объект
connection
, доступный черезnavigator.connection
, предоставляет информацию о сотовых и wifi подключениях устройства.
Это свойство предоставляет быстрый способ для определения состояния подключения устройства к сети и тип этого подключения.
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();
До Cordova 2.3.0 объект Connection
был доступен через navigator.network.connection
, после чего это свойство было изменено на navigator.connection
в соответствии со спецификацией консорциума W3C. Он все еще доступен в его исходном расположении, но это расположение является устаревшим и в конечном итоге будет удалено.
navigator.connection.type
имеет значение Connection.CELL
для всех сотовых данных.Когда работает в эмуляторе, тип подключения всегда определяется navigator.connection.type
как Connection.UNKNOWN
.
Windows Phone не может определить тип подключения к сотовой сети.
navigator.connection.type
имеет значение Connection.CELL
для всех сотовых данных.navigator.connection.type
имеет значение Connection.CELL_2G
для всех сотовых данных.navigator.connection.type
имеет значение Connection.CELL
для всех сотовых данных.Событие возникает, когда приложение переходит в автономный режим, и устройство не подключено к сети Интернет.
document.addEventListener("offline", yourCallbackFunction, false);
Событие offline
возникает, когда ранее подключенное устройство теряет подключение к сети, так что приложение больше не может получить доступ к Интернет. Он опирается на ту же информацию, что и Connection API и срабатывает, когда значение connection.type
становится равным NONE
.
Приложения обычно должно использовать window.addEventListener
чтобы добавить обработчик события после того как произойдет событие deviceready
.
document.addEventListener("offline", onOffline, false); function onOffline() { // Handle the offline event }
Во время первоначального запуска первому событию offline (если применимо) требуется по крайней мере секунду на срабатывание.
Когда работает в эмуляторе, connection.status
всегда неизвестен, так что это событие не срабатывает.
Эмулятор сообщает тип подключения как Cellular
, которое не меняется, поэтому событие не не срабатывает.
Это событие возникает, когда приложение выходит в онлайн, и устройство подключается к Интернету.
document.addEventListener("online", yourCallbackFunction, false);
Событие online
возникает, когда ранее не подключенное к сети устройство получает сетевое подключение, разрешающее приложению доступ к Интернету. Оно опирается на ту же информацию, Connection API и вызывается когда connection.type
меняется с NONE
в любое другое значение.
Приложения обычно должны использовать window.addEventListener
чтобы добавить обработчик события после того как произойдет событие deviceready
.
document.addEventListener("online", onOnline, false); function onOnline() { // Handle the online event }
Во время первоначального запуска первое событие online
(если применимо) занимает по меньшей мере секунду на срабатывание, до этого момента connection.type
является равным UNKNOWN
.
Когда работает в эмуляторе, connection.status
всегда неизвестен, так что это событие не срабатывает.
Эмулятор сообщает тип подключения как Cellular
, которое не меняется, поэтому событие не не срабатывает.