NetworkInformation

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

**NetworkInformation ** 接口提供有关设备用于与网络通信的连接的信息，并提供了一种在连接类型更改时通知脚本的方法。NetworkInformation 接口不能被实例化。而是通过 Navigator 接口的 connection 属性来访问它。

The **NetworkInformation** interface provides information about the connection a device is using to communicate with the network and provides a means for scripts to be notified if the connection type changes.

注意： 此特性在 Web Worker 中可用。

属性

该接口还继承了其父接口 EventTarget} 的属性。

返回有效带宽估计值（以兆位 / 秒为单位），四舍五入为每秒 25 KB 的最接近倍数。

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

事件处理程序

NetworkInformation.onchange

当连接信息更改并且在该对象上触发 change 时触发的事件。

方法

该接口还继承了其父接口 EventTarget 的方法。

规范

规范 状态 备注
Network Information API
NetworkInformation 的定义		 编者的草案 初始定义

{{ Compat }}

相关链接