NetworkInformation

これは実験的な機能です。本番で使用する前にブラウザー実装状況をチェックしてください。

NetworkInformation インターフェースは、デバイスがネットワーク通信に使用している接続の情報を提供します。また、接続の種類が変更した場合、スクリプトに通知する手段を提供します。NetworkInformation インターフェースは、インスタンス生成できません。代わりに、Navigator インターフェースの connection プロパティを通してアクセスします。

プロパティ

このインターフェースは、親である EventTarget のプロパティも継承しています。

NetworkInformation.type 読取専用
デバイスがネットワーク通信に使用している接続の種類を返す。値は次のうちのいずれかである：
  • bluetooth
  • cellular
  • ethernet
  • none
  • wifi
  • wimax
  • other
  • unknown
NetworkInformation.downlinkMax 読取専用
メガビット毎秒（Mbps）単位で、基底の接続技術の最大下り速度を返す。

イベントハンドラ

NetworkInformation.onchange
接続情報が変更されたときに発火するイベントで、このオブジェクトで change が発火する。

メソッド

このインターフェースは、親である EventTarget のメソッドを継承しています。

仕様

仕様 ステータス コメント
Network Information API
NetworkInformation の定義		 ドラフト 最初の定義

ブラウザ実装状況

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから！

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 20 webkit 31.0 moz[1] 未サポート 未サポート 未サポート
機能 Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
基本サポート 未サポート 未サポート 31.0 moz[1] 未サポート 未サポート 未サポート 未サポート

[1] Network API は、dom.network.enabled 設定で無効化できます。Gecko 12.0 から Gecko 30.0 に含まれており、このインターフェースは Connection と呼ばれており、異なるメンバーを持っていました。Gecko 12.0 では、Android システムでのみ Network API が実装されていました。Linux (バグ 712442) と Windows (バグ 721306) でのサポートは進行中です。

関連項目