NetworkInformation
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-
端末がネットワーク通信に使用している接続の種類を返します。値は次のうちのいずれかです。
bluetooth
cellular
ethernet
none
wifi
wimax
other
unknown
インスタンスメソッド
このインターフェイスは、親である EventTarget
のメソッドを継承しています。
イベント
change
Experimental-
接続情報が変更されたときに発行されるイベントです。
仕様書
Specification |
---|
Network Information API # networkinformation-interface |
ブラウザーの互換性
BCD tables only load in the browser