NetworkInformation - 提供设备与网络通信的连接的信息

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

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

NetworkInformation 接口提供有关设备与网络通信的连接的信息,并提供一种在连接类型更改时通知脚本的方法。

注意: 此特性在 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 的定义
编者的草案 初始定义

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持61 不支持 不支持 不支持48 不支持
downlink61 不支持 不支持 不支持48 不支持
downlinkMax611 不支持 不支持 不支持 不支持 不支持
effectiveType61 不支持 不支持 不支持48 不支持
onchange61 不支持 不支持 不支持48 不支持
ontypechange 不支持 不支持 不支持 不支持 未知 不支持
rtt61 不支持 不支持 不支持48 不支持
saveData65 不支持 不支持 不支持 支持 不支持
type611 不支持 不支持 不支持 不支持 不支持
Available in workers61 不支持 不支持 不支持48 不支持

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持5038 未知31 未知45 不支持
downlink5038 未知 未知 未知45 不支持
downlinkMax5038 未知 不支持 未知45 不支持
effectiveType5038 未知 支持 未知45 不支持
onchange5038 未知 不支持2 未知45 不支持
ontypechange 不支持 不支持 未知 未知 未知 未知 不支持
rtt5038 未知 不支持 未知45 不支持
saveData6565 未知 未知 未知 支持 不支持
type5038 未知 不支持 未知45 不支持
Available in workers5038 未知53 未知45 不支持

1. 仅在 Chrome 操作系统中受支持

2. 在 Firefox 上,与 change 事件对应的事件处理程序属性为 ontypechange

相关链接