Подключение

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

Доступ к функции

Начиная с версии 3.0 Кордова реализует интерфейсы API уровень устройства как плагины. Использование CLI plugin команды, описанные в интерфейс командной строки, чтобы добавить или удалить эту функцию для проекта:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
    $ cordova plugin rm org.apache.cordova.core.network-information

Эти команды применяются для всех целевых платформ, но изменить параметры конфигурации платформы, описанные ниже:

• Андроид

  (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" />
  

• Ежевика WebWorks

  (in www/plugins.xml)
  <feature name="Network Status">
      <param name="blackberry-package" value="org.apache.cordova.network.Network" />
  </feature>
  

• iOS (вconfig.xml)

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

• Windows Phone (вProperties/WPAppManifest.xml)

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

  Ссылка: манифест приложения для Windows Phone

• Tizen (вconfig.xml)

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

  Ссылка: манифест приложения для Tizen веб-приложения

Некоторые платформы могут поддерживать эту функцию без необходимости специальной настройки. Смотрите поддержку платформы обзор.

---

connection.type

Проверяет в настоящее время активное сетевое подключение.

Описание

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

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

• iOS
• Андроид
• WebWorks ежевики (OS 5.0 и выше)
• Tizen
• Windows Phone 7 и 8
• ОС Windows 8

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

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

Полный пример

<!DOCTYPE html>
<html>
  <head>
    <title>navigator.connection.type Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        checkConnection();
    }

        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]);
        }

    </script>
  </head>
  <body>
    <p>A dialog box will report the network state.</p>
  </body>
</html>

Изменения API

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

iOS причуды

• iOS не может определить тип подключения к сотовой сети.
  • navigator.connection.type is set to Connection.CELL for all cellular data.

Windows Phone причуды

• When running in the emulator, always detects navigator.connection.type as Connection.UNKNOWN.

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

  • navigator.connection.type is set to Connection.CELL for all cellular data.

Tizen причуды

• Tizen может только обнаружить Wi-Fi или сотовой связи.
  • navigator.connection.type is set to Connection.CELL_2G for all cellular data.