使用 Network Information API 实现自适应内容:以回退为先
使用可选网络提示做出可逆资源选择,同时遵守标准、隐私和 BotBrowser 能力边界。
BotBrowser Team
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 缺失时运行上述示例,再启用自适应增强。
常见问题
downlink 是测速结果吗?
不是。它是可能取整、过期并受其他流量影响的浏览器估计。真实请求结果更有意义。
什么是下一步安全行动?
加入特性检测、基础体验夹具和一次有界重试测试。在收集指标前,让无障碍和隐私审核者确认策略。
被取消的增强如何恢复?
保留基础内容并显示一次重试控件。不要因为每次估计变化而重载整页。
应如何处理缓存?
使用明确的产品变体,不要用详细网络指纹作为键。没有提示时仍应返回完整响应。
何时复查策略?
浏览器、媒体集合或负载变化后复查,并重跑 API 缺失、部分属性、unknown、saveData 和中断传输测试。
API 缺失是否必须减少内容?
不必。缺失表示未知。保留基础体验,只减少已解释且可逆的可选工作。
BotBrowser 能保证慢或快的路径吗?
不能。它为受控测试配置报告值,不保证物理吞吐量、代理行为、API 普遍可用或网站响应。
应记录什么?
记录策略、负载版本、完成、取消和恢复。避免原始值,并在复盘后删除临时诊断数据。
来源
本文属于指南: Web 平台能力面:一致性复核地图