NetworkInformation - 提供设备与网络通信的连接的信息
这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
NetworkInformation
接口提供有关设备用于与网络通信的连接的信息,并提供了一种在连接类型更改时通知脚本的方法。NetworkInformation
接口不能被实例化。而是通过 Navigator
接口的 connection
属性来访问它。
NetworkInformation 接口提供有关设备与网络通信的连接的信息,并提供一种在连接类型更改时通知脚本的方法。
注意: 此特性在 Web Worker 中可用。
属性
该接口还继承了其父接口 EventTarget
的属性。
NetworkInformation.downlink
只读
返回有效带宽估计值(以兆位 / 秒为单位),四舍五入为每秒 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 的定义 |
编者的草案 | 初始定义 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 61 | 不支持 | 不支持 | 不支持 | 48 | 不支持 |
downlink | 61 | 不支持 | 不支持 | 不支持 | 48 | 不支持 |
downlinkMax | 611 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 |
effectiveType | 61 | 不支持 | 不支持 | 不支持 | 48 | 不支持 |
onchange | 61 | 不支持 | 不支持 | 不支持 | 48 | 不支持 |
ontypechange | 不支持 | 不支持 | 不支持 | 不支持 | 未知 | 不支持 |
rtt | 61 | 不支持 | 不支持 | 不支持 | 48 | 不支持 |
saveData | 65 | 不支持 | 不支持 | 不支持 | 支持 | 不支持 |
type | 611 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 |
Available in workers | 61 | 不支持 | 不支持 | 不支持 | 48 | 不支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 50 | 38 | 未知 | 31 | 未知 | 45 | 不支持 |
downlink | 50 | 38 | 未知 | 未知 | 未知 | 45 | 不支持 |
downlinkMax | 50 | 38 | 未知 | 不支持 | 未知 | 45 | 不支持 |
effectiveType | 50 | 38 | 未知 | 支持 | 未知 | 45 | 不支持 |
onchange | 50 | 38 | 未知 | 不支持2 | 未知 | 45 | 不支持 |
ontypechange | 不支持 | 不支持 | 未知 | 未知 | 未知 | 未知 | 不支持 |
rtt | 50 | 38 | 未知 | 不支持 | 未知 | 45 | 不支持 |
saveData | 65 | 65 | 未知 | 未知 | 未知 | 支持 | 不支持 |
type | 50 | 38 | 未知 | 不支持 | 未知 | 45 | 不支持 |
Available in workers | 50 | 38 | 未知 | 53 | 未知 | 45 | 不支持 |
1. 仅在 Chrome 操作系统中受支持
2. 在 Firefox 上,与 change
事件对应的事件处理程序属性为 ontypechange
。