NetworkInformation

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

NetworkInformation 是 网络信息 API 的一个接口，它提供有关设备用于与网络通信的连接的信息，并为脚本提供了一种方法，以便在连接类型更改时收到通知。NetworkInformation 接口无法实例化。它可以通过 Navigator 接口或 WorkerNavigator 接口的 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

连接信息更改时触发的事件。

规范

规范
网络信息 API
# networkinformation-interface

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅