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

インスタンスプロパティ

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

実効帯域幅の推定値をメガビット毎秒で返します。 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

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
NetworkInformation
change event
downlink
downlinkMax
Experimental
effectiveType
rtt
saveData
type
Experimental
typechange event
DeprecatedNon-standard
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.

関連項目