Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

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 の定義
勧告改訂案 最初の定義

ブラウザ実装状況

機能 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) でのサポートは進行中です。

関連項目

ドキュメントのタグと貢献者

 このページの貢献者: YuichiNukiyama, jprichardson
 最終更新者: YuichiNukiyama,