これがないドキュメントの最新バージョンです!
Click here for the latest released version.
connection.type
使われているネットワーク接続のタイプを確認します。
概要
このプロパティーは、デバイスのネットワーク接続状態や接続のタイプを手早く取得出来ます。
サポートされているプラットフォーム
- iOS
- Android
- BlackBerry WebWorks (OS 5.0 以上)
- Windows Phone 7 (Mango)
- Bada 2.x
- webOS
- Tizen
使用例
function checkConnection() {
var networkState = navigator.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.connection.type 使用例</title>
<script type="text/javascript" charset="utf-8" src="cordova-2.2.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.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>
API の変更点
Cordova 2.2.0 以前では、 Connection オブジェクトは navigator.network.connection
にありました。
仕様と一致させるため、これは 2.2.0 で navigator.connection
に変更されました。
navigator.network.connection
はまだ存在していますが、非推奨であり、将来削除されるでしょう。
iOS に関する注意点
- iOS はネットワーク接続のタイプを特定することが出来ません。
- 携帯電話ネットワークでの接続時、
navigator.connection.type
にはConnection.CELL_2G
がセットされます。
- 携帯電話ネットワークでの接続時、
Bada に関する注意点
- Bada は WiFi または 携帯電話ネットワークに接続されているかどうかのみを特定できます。
- 携帯電話ネットワークでの接続時、
navigator.connection.type
にはConnection.CELL_2G
がセットされます。
- 携帯電話ネットワークでの接続時、
webOS に関する注意点
- 接続が確立されているかのみを表し、タイプについては特定できません。
Windows Phone に関する注意点
- Windows Phone Emulator は常に
navigator.connection.type
を[Connection](connection.html).UNKNOWN
と返します。
Tizen に関する注意点
- Tizen は WiFi または 携帯電話ネットワークに接続されているかどうかのみを特定できます。
- 携帯電話ネットワークでの接続時、
navigator.connection.type
にはConnection.CELL_2G
がセットされます。
- 携帯電話ネットワークでの接続時、