返回知识中心
指纹

Battery Status API:隐私边界、可用性与稳妥的网页决策

了解 Battery Status API 能提供哪些信息、为何支持有限,以及如何在不建立用户画像的情况下使用电池状态。

BotBrowser Team

文档中心

想直接进入 指纹 文档吗?

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

当网页想减少可选工作时,Battery Status API 看起来很有用,但它很容易被过度解读。信号可能不存在、被取整,或在读取后立即变化,因此不能把电池读数变成渲染、授权或账户决策的隐藏前提。

要点

  • 先检测 navigator.getBattery(),缺失或被拒绝时仍保持基础体验可用。
  • 只把读数用于小范围、可撤销的选择,例如推迟预览或减少后台刷新。
  • 不要把原始电池字段放入标识符、URL、分析标签或长期支持记录。
  • BotBrowser 可以在选定 profile 中测试暴露路径与回退路径,但不会让 API 变为可用,也不保证运行时间。

Battery Status API 的可用性、本地决策与回退流程

内容导航

Battery Status API 提供什么

当浏览器暴露 navigator.getBattery() 时,应用可以调用它。返回的 BatteryManager 可能提供 charging、level、chargingTime 和 dischargingTime,并提供状态变化事件。这些值描述浏览器当前看到的电源状态,不是硬件清单、精确的剩余使用时间保证,也不是电池健康度测量。

这些值会在一次访问期间变化,也可能因浏览器策略而不可用、被取整或受到其他限制。应把它们当作当前任务的提示。例如设备未充电时,页面可以推迟可选动画或降低后台刷新频率,但不应删除必需内容,也不应据此推断使用者身份。

把不可用当作正常兼容分支

MDN 将 Battery Status API 标为支持有限,因此生产页面不能假定存在 navigator.getBattery,也不能假定 Promise 一定成功。支持情况可能随浏览器、版本、上下文和用户代理策略变化。应先确认接口是否存在,处理拒绝,并在没有值时继续使用同一个基础体验。

不要用浏览器名称代替特性检测。测试产品真正需要的行为:API 缺失、值发生变化或请求失败时,页面仍然可用。浏览器能力指南也介绍了对可选 API 采用回退优先的方法。

做出小而可撤销的产品决策

先设计不依赖电池数据的基础体验。如果有结果,再在少量策略中选择,例如正常模式或减少后台工作的模式。导航、表单、媒体替代内容和无障碍控件都应保留。如果变化会影响数据传输、质量或等待时间,应使用普通产品语言说明,并在适当时让用户选择。

电池状态不应控制授权、计费、账户恢复或必需请求。服务器不应依赖可能缺失、且会在请求之间变化的 JavaScript 电池值。如果用户明确选择了省流量或减少效果模式,应发送这个选择,而不是原始电池字段。关于不暴露设备细节的客户端验证,可参阅Private Verification Tokens:Chrome 正在探索什么,以及 BotBrowser 当前如何处理。

隐私边界与数据最小化

电池读数与其他信号结合时可能增加指纹识别风险。只在需要它的决策范围内使用,并在页面选定策略后丢弃原始值。默认不要把 level、充电状态或时间值加入账户标识符、URL、分析标签或长期支持记录。关于另一个与用户偏好相关的浏览器信号,可参阅Keyboard Layout API、区域设置与隐私。

运维日志通常只需要记录已选策略和结果,例如 power_policy=reduced 以及可选任务是否完成。如果支持个案确实需要更多细节,应说明用途、限制访问、设置较短的保留期限,并在个案结束时删除字段。浏览器隐私基础指南介绍了更广泛的数据最小化做法。

测试回退,而不是测试某个电量数值

测试应覆盖 API 未定义、getBattery() 被拒绝、level 或 charging 变化,以及只提供基础路径的浏览器。断言必需内容和控件仍可用、可选工作可以取消、状态变化后用户可以恢复。不要断言某个设备必须返回某个百分比或时间。

每个分支都要尊重用户意图和无障碍要求。减少模式可以推迟预览或降低后台频率,但必须保留任务含义,并提供清晰的继续方式。避免重试循环,也不要要求用户削弱浏览器隐私设置来启用可选增强功能。

电池接口描述的是浏览上下文看到的状态,而不是操作系统的承诺。

浏览器可能返回稍旧的值,也可能有意降低精度。

代码应能容忍刚读取的值立即变化。

异步结果到达前,默认行为也必须正确。

Promise 被拒绝和方法不存在,都表示增强功能暂时不可用。

这种结果不应变成阻塞页面的警告。

页面重新可见时可以重新计算短期决策。

不要为了得到缺失信号而持续重复请求。

私密窗口、嵌入框架和托管配置都可能改变可用性。

应描述已测试的行为,不要承诺整个浏览器系列都支持。

可选预览缺失时,文章和控件仍应正常加载。

长操作可以提供暂停或降低质量的选择。

保存已输入的数据,并让恢复操作可重复执行。

充电状态变化时,只重新评估受影响的可选工作。

不要在交互中途静默改变内容或质量。

客户端错误报告和第三方库也可能复制电池字段。

离开页面的事件应采用字段允许列表。

单个标签页的策略留在内存中即可。

缺少接口时继续普通体验,可以减少形成电源状态历史的机会。

BotBrowser 支持边界

BotBrowser 支持团队使用选定的浏览器 profile 测试应用如何处理浏览器暴露的 Battery Status API,以及 API 不可用时如何进入回退流程。这种基于 profile 的工作流不会让 API 变为可用,也不会设定应用的调度策略;API 是否可用仍取决于浏览器和 profile 策略。读数不保证运行时间,也不授权账户。

实践结论

把 Battery Status API 当作可选且短暂的输入。在使用点检测它,不可用时保留普通路径,并向用户说明有意义的延迟或质量选择。在选定 profile 和不提供该 API 的浏览器中分别验证两条路径,记录策略结果,不记录原始电池字段。

来源

#Battery Status API#电池状态#隐私#能力检测

本文属于指南: 什么是浏览器指纹?原理、风险、信号与隐私边界

在 BotBrowser 里跑一遍同样的检查

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