tree: 7805bc5f170d487a4e4c5a9e769dedc0424e77eb [path history] [tgz]
  1. README.md
  2. index.md
doc/ja/README.md

cordova-plugin-network-information

Build Status

このプラグインは、古いバージョンのネットワーク情報 APIの実装を提供します。 デバイスの携帯電話や wifi 接続に関する情報を提供し、かどうか、デバイスがインターネットに接続します。

インストール

cordova plugin add cordova-plugin-network-information

サポートされているプラットフォーム

  • アマゾン火 OS
  • アンドロイド
  • ブラックベリー 10
  • ブラウザー
  • iOS
  • Windows Phone 7 と 8
  • Tizen
  • Windows
  • Firefox の OS

Connection

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 すべての携帯電話データの。

Windows の癖

  • 電話 8.1 エミュレーターで実行する場合は、常に Connection.ETHERNET として navigator.connection.type を検出します.

Tizen の癖

  • Tizen には、WiFi または携帯電話の接続だけを検出できます。
    • navigator.connection.type は、すべての携帯電話のデータを Connection.CELL_2G に設定されます。

Firefox OS 癖

  • Firefox の OS は、携帯電話のネットワーク接続の種類を検出できません。
    • navigator.connection.type設定する Connection.CELL すべての携帯電話データの。

ブラウザーの癖

  • ブラウザーは、ネットワーク接続の種類を検出できません。 navigator.connection.typeは、 Connection.UNKNOWNオンライン時に常に設定されます。

ネットワーク関連のイベント

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 の癖

初回起動時 (当てはまる場合) の最初のオフライン イベントは火に 1 秒以上かかります。

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 (当てはまる場合) イベントが少なくとも火を前に第 2 connection.typeUNKNOWN.

Windows Phone 7 の癖

エミュレーターで実行しているとき、 connection.status は常に知られている、このイベントはない火。

Windows Phone 8 癖

エミュレーターと接続の種類のレポート Cellular は変化しません、イベントはない火。