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 読取専用

基盤となる接続技術の下りの最大速度を、メガビット毎秒 (Mbps) 単位で返します。

NetworkInformation.effectiveType 読取専用

'slow-2g', '2g', '3g', '4g' のいずれかを意味する接続の有効な種類を返します。この値は、最近観測されたラウンドトリップ時間とダウンリンク値の組合せを使用して決定されます。

NetworkInformation.rtt 読取専用

推定有効ラウンドトリップ時間を、 25 ミリ秒の倍数に丸めた値で返します。

NetworkInformation.saveData 読取専用

ユーザーがユーザーエージェントにデータ使用量の削減オプションを設定している場合、 true を返します。

NetworkInformation.type 読取専用

端末がネットワーク通信に使用している接続の種類を返します。値は次のうちのいずれかです。

  • bluetooth
  • cellular
  • ethernet
  • none
  • wifi
  • wimax
  • other
  • unknown

インスタンスメソッド

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

イベント

change

接続情報が変更されたときに発行されるイベントです。

仕様書

Specification
Network Information API
# networkinformation-interface

ブラウザーの互換性

BCD tables only load in the browser

関連項目