このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
NetworkInformation
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental:これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
NetworkInformation はネットワーク情報 API のインターフェイスで、端末がネットワークとの通信に使用している接続に関する情報を提供し、接続の種類が変更された場合にスクリプトに通知するための手段を提供します。NetworkInformation インターフェイスはインスタンスを生成できません。代わりに、Navigator インターフェイスのconnection プロパティを通してアクセスします。
メモ: この機能はウェブワーカー内で利用可能です。
インスタンスプロパティ
このインターフェイスは、親であるEventTarget のプロパティも継承しています。
NetworkInformation.downlink読取専用Experimental実効帯域幅の推定値をメガビット毎秒で返します。 25 キロビット毎秒の最も近い倍数に丸められた値です。
NetworkInformation.downlinkMax読取専用Experimental基盤となる接続技術の下りの最大速度を、メガビット毎秒 (Mbps) 単位で返します。
NetworkInformation.effectiveType読取専用Experimental'slow-2g', '2g', '3g', '4g' のいずれかを意味する接続の有効な種類を返します。この値は、最近観測されたラウンドトリップ時間とダウンリンク値の組合せを使用して決定されます。
NetworkInformation.rtt読取専用Experimental推定有効ラウンドトリップ時間を、 25 ミリ秒の倍数に丸めた値で返します。
NetworkInformation.saveData読取専用Experimentalユーザーがユーザーエージェントにデータ使用量の削減オプションを設定している場合、
trueを返します。NetworkInformation.type読取専用Experimental端末がネットワーク通信に使用している接続の種類を返します。値は次のうちのいずれかです。
bluetoothcellularethernetnonewifiwimaxotherunknown
インスタンスメソッド
このインターフェイスは、親であるEventTarget のメソッドを継承しています。
イベント
changeExperimental接続情報が変更されたときに発行されるイベントです。
仕様書
| Specification |
|---|
| Network Information API # networkinformation-interface |