Connection

connection オブジェクトを通じて、携帯電話ネットワーク及び wifi 接続情報にアクセス出来ます。

このオブジェクトは、 navigator.network インターフェース以下からアクセスされます。

プロパティー

• connection.type

定数

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

WP7 に関する注意点

• type: Windows Phone Emulator は常に navigator.network.connection.type を Connection.UNKNOWN と返します。

iOS に関する注意点

• type: iOS は、デバイスが携帯電話ネットワークに接続しているかどうかだけを返すことができ、タイプは返すことが出来ません。 そのため、もし接続している場合は常に CELL_2G として返されます。

Bada に関する注意点

• Bada は、デバイスが Wifi または CELL_2G 携帯電話ネットワークに接続されているかどうかのみを返します (タイプは返されません) 。

---

connection.type

使われているネットワーク接続のタイプを確認します。

概要

このプロパティーは、デバイスのネットワーク接続状態や接続のタイプを手早く取得出来ます。

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

• iOS
• Android
• BlackBerry WebWorks (OS 5.0 以上)
• Windows Phone 7 (Mango)
• Bada 2.x

使用例

function checkConnection() {
    var networkState = navigator.network.connection.type;

    var states = {};
    states[Connection.UNKNOWN]  = '不明な接続';
    states[Connection.ETHERNET] = 'イーサネット接続';
    states[Connection.WIFI]     = 'WiFi接続';
    states[Connection.CELL_2G]  = '2G接続';
    states[Connection.CELL_3G]  = '3G接続';
    states[Connection.CELL_4G]  = '4G接続';
    states[Connection.NONE]     = 'ネットワーク接続なし';

    alert('コネクションタイプ: ' + states[networkState]);
}

checkConnection();

詳細な使用例

<!DOCTYPE html>
<html>
  <head>
    <title>navigator.network.connection.type 使用例</title>

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

    // Cordova の読み込み完了まで待機
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova 準備完了
    //
    function onDeviceReady() {
        checkConnection();
    }

    function checkConnection() {
        var networkState = navigator.network.connection.type;

        var states = {};
        states[Connection.UNKNOWN]  = '不明な接続';
        states[Connection.ETHERNET] = 'イーサネット接続';
        states[Connection.WIFI]     = 'WiFi接続';
        states[Connection.CELL_2G]  = '2G接続';
        states[Connection.CELL_3G]  = '3G接続';
        states[Connection.CELL_4G]  = '4G接続';
        states[Connection.NONE]     = 'ネットワーク接続なし';

        alert('コネクションタイプ: ' + states[networkState]);
    }

    </script>
  </head>
  <body>
    <p>ダイアログボックスがネットワーク状態を表示します。</p>
  </body>
</html>