大网数据广告活动
Web 标准与前端开发

网络信息 API

· 52CE 我爱测

网络信息 API** 提供关于系统连接的一般连接类型(如“wifi”、“cellular”等)的信息。应用程序可以根据用户的连接为用户展现不同清晰度的内容。

Network Information API

网络信息 API 提供关于系统连接的一般连接类型(如“wifi”、“cellular”等)的信息。应用程序可以根据用户的连接为用户展现不同清晰度的内容。

该接口由一个单例 NetworkInformation 对象组成,其实例由 Navigator.connection 属性或 WorkerNavigator.connection 属性返回。

接口

  • NetworkInformation
    • : 提供设备用来与网络通信的连接信息,并在连接类型发生变化时为脚本提供通知的方式。NetworkInformation 接口不能被实例化。它可以通过 Navigator 接口或 WorkerNavigator 接口访问。

其他接口的扩展

  • Navigator.connection
    • : 返回一个 NetworkInformation 对象,其包含有关设备的网络连接的信息。
  • WorkerNavigator.connection
    • : 提供一个 NetworkInformation 对象,其包含有关设备的网络连接的信息。

示例

侦测连接状态变化

下面是一个侦测用户设备连接状态变化的例子。

let type = navigator.connection.effectiveType;

function updateConnectionStatus() {
  console.log(
    `设备的网络连接从 ${type} 变为了 ${navigator.connection.effectiveType}`,
  );
  type = navigator.connection.effectiveType;
}

connection.addEventListener("change", updateConnectionStatus);

预加载大型资源

连接对象对于决定是否预装占用大量带宽或内存的资源很有用。该示例将在页面加载后不久被调用,以检查可能不需要预加载视频的连接类型。如果发现有蜂窝网络连接,那么 preloadVideo 标志被设置为 false。为了简单和清楚起见,此例子仅测试了一种连接类型。真实世界的用例可能会使用 switch 语句或其他一些方法来检查 NetworkInformation.type 的所有可能值。无论 type 值如何,你都可以通过 NetworkInformation.effectiveType 属性获得连接速度的估计值。

let preloadVideo = true;
const connection = navigator.connection;
if (connection) {
  if (connection.effectiveType === "slow-2g") {
    preloadVideo = false;
  }
}

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。