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.