返回知识中心
平台

使用 Network Information API 实现自适应内容:以回退为先

使用可选网络提示做出可逆资源选择,同时遵守标准、隐私和 BotBrowser 能力边界。

BotBrowser Team

文档中心

想直接进入 平台 文档吗?

这篇文章属于知识中心的指南库。若你要步骤化配置、参考说明和持续更新,请直接进入对应 docs 分区。

WICG 与 MDN 将 Network Information API 的 navigator.connection 定义为可选的粗略浏览器提示,而不是带宽测试或身份信号。BotBrowser 可以在 profile 中配置 RTT、downlink 等报告值,但不保证路径的实际吞吐量,也不保证 API 在所有环境可用。稳妥做法是先渲染完整基础体验,逐项做特性检测,并让可选变化可逆。

摘要

  • 将 effectiveType、rtt、downlink 和 saveData 当作估计或偏好。
  • 必需内容、权限和账户决策必须独立于该 API。
  • 使用 baseline、reduced 等少量策略,测量结果并提供恢复路径。
  • 解释重要传输变化,尊重明确选择,避免长期保存原始值。
  • BotBrowser 可为测试设置报告值,但不模拟物理带宽。

目录

以回退为先、使用网络提示选择自适应内容的流程

API 提供哪些信息

NetworkInformation 可能提供 effectiveType、rtt、downlink、saveData,部分实现还提供 type。前者把观测条件分为 slow-2g、2g、3g、4g 等;中间两项是浏览器估计;saveData 表示减少数据使用的请求。W3C/WICG 定义接口,MDN 记录运行时可用性。值可能被取整、过期、缺失或改变。

把 API 当作可选能力。对象缺失、属性为 undefined、类型为 unknown 或出现异常值时,必需文本、控件和导航仍须可用。不要从单个分类推断国家、设备、身份或保证的网络性能。

可逆的决策规则

先定义不依赖提示也能工作的策略。使用描述行为的名称而不是猜测设备,并让用户明确选择优先。

const connection = navigator.connection;
const reduced = Boolean(
  connection && (connection.saveData || connection.effectiveType === 'slow-2g' || connection.effectiveType === '2g')
);
const policy = reduced ? 'reduced' : 'baseline';
// 只做可逆的可选工作;必需内容仍会渲染。
产品问题选择规则预期回退
是否预取可选文章?临时使用 saveData 或保守类型。跳过预取,保留链接。
是否启动自动播放预览?结合策略、播放偏好和页面状态。显示海报图和播放控件。
是否交付必需文档?绝不由此 API 阻断。直接加载并说明可选升级。

4g 不保证大型传输成功,缺少值也不证明连接很慢。应观察真实请求的完成、解码失败、取消、输入延迟和恢复情况。

变化、隐私与回退

连接对象可能触发 change。用它暂停或取消排队的增强工作,不要移除已经可用的内容。对变化做防抖,限制重试,在组件销毁时移除监听器,并提供清晰的重试。资源延迟时仍要保留表单输入、布局空间、键盘访问和可访问加载状态。

网络提示与其他信号结合后可能增加指纹信息。优先临时使用,并在账户标识符、长期日志或分析中使用 reduced 这类策略标签,而不是原始 rtt、downlink 或 effectiveType。低质量图片或延后预取是产品决策,不是收集更多数据的授权。必需请求、权限、授权和账户决策保持独立。关于这些提示会暴露什么以及如何在缺少提示时回退,可参阅Network Information API:连接提示、隐私边界与回退。

响应式图片、延迟加载、流式背压、有界缓存、取消和服务端渲染的基础 HTML 在 API 缺失时仍有用。开始有明显成本的传输前要解释,并允许用户请求完整分辨率。

测试与 BotBrowser 边界

测试 navigator.connection 缺失、仅部分属性存在、saveData: true,以及可选传输中断时的 change 事件。另测 unknown。验证行为:必需文本可读、键盘控件可用、可选工作恢复且没有无限循环。

BotBrowser 支持为报告值配置 profile 策略,包括 RTT 和 downlink,以检查应用如何处理声明的提示。这会改变测试上下文中的浏览器报告值,但不会改变代理吞吐量、测量物理路径、保证 API 可用或决定网站如何分类会话。

参考 Network Information 规范、MDN NetworkInformation 参考 和 MDN API 概览。另见 Network Information 指纹指南 与 Client Hints 指纹指南。

结论

将 Network Information 作为可逆资源策略的临时输入。保留完整基础体验,尊重用户意图,测量真实请求,只保留最少证据。下一步是在 API 缺失时运行上述示例,再启用自适应增强。

常见问题

不是。它是可能取整、过期并受其他流量影响的浏览器估计。真实请求结果更有意义。

什么是下一步安全行动?

加入特性检测、基础体验夹具和一次有界重试测试。在收集指标前,让无障碍和隐私审核者确认策略。

被取消的增强如何恢复?

保留基础内容并显示一次重试控件。不要因为每次估计变化而重载整页。

应如何处理缓存?

使用明确的产品变体,不要用详细网络指纹作为键。没有提示时仍应返回完整响应。

何时复查策略?

浏览器、媒体集合或负载变化后复查,并重跑 API 缺失、部分属性、unknown、saveData 和中断传输测试。

API 缺失是否必须减少内容?

不必。缺失表示未知。保留基础体验,只减少已解释且可逆的可选工作。

BotBrowser 能保证慢或快的路径吗?

不能。它为受控测试配置报告值,不保证物理吞吐量、代理行为、API 普遍可用或网站响应。

应记录什么?

记录策略、负载版本、完成、取消和恢复。避免原始值,并在复盘后删除临时诊断数据。

来源

#Network Information API#自适应内容#effectiveType#Web 性能#隐私

本文属于指南: Web 平台能力面:一致性复核地图

在 BotBrowser 里跑一遍同样的检查

加载 profile,让刚读到的这些信号在浏览器内部保持一致,并在正式上线前先在自己的机器上确认结果。