1. Web
  2. Web API
  3. NetworkInformation

NetworkInformation

可用性有限

此特性不是基線特性，因為它在一些最廣泛使用的瀏覽器中不起作用。

注意：此功能在 Web Workers 中可用。

NetworkInformation 介面是 Network Information API 的一部分，它提供了有關裝置用於與網路通訊的連線資訊，並允許指令碼在連線型別發生變化時收到通知。NetworkInformation 介面不能被例項化。而是透過 Navigator 介面的 connection 屬性或 WorkerNavigator 介面進行訪問。

EventTarget NetworkInformation

例項屬性

該介面還繼承了其父介面 EventTarget 的屬性。

以兆位元每秒（Mbps）為單位返回有效頻寬估算值，並四捨五入到最接近的 25 千位元每秒（Kbps）的倍數。

NetworkInformation.downlinkMax 只讀

以兆位元每秒（Mbps）為單位返回底層連線技術的最大下行速度。

NetworkInformation.effectiveType 只讀

返回連線的有效型別，即 'slow-2g'、'2g'、'3g' 或 '4g' 之一。此值是透過結合最近觀察到的往返時間和下行鏈路值確定的。

NetworkInformation.rtt 只讀

以毫秒（ms）為單位返回當前連線的估計有效往返時間，並四捨五入到最接近的 25 毫秒的倍數。

NetworkInformation.saveData 只讀

如果使用者在使用者代理上設定了降低資料使用量的選項，則返回 true。

NetworkInformation.type 只讀

返回裝置用於與網路通訊的連線型別。它將是以下值之一：

  • bluetooth
  • cellular
  • ethernet
  • none
  • wifi
  • wimax
  • 其他
  • unknown

例項方法

該介面還繼承了其父介面 EventTarget 的方法。

事件

change

當連線資訊發生變化時觸發的事件。

規範

規範
Network Information API
# networkinformation-interface

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ，由 MDN 貢獻者 修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤
© . Content available under a Creative Commons license.