浏览器 API 兼容数据与功能回退
结合公开兼容数据、运行时检测和隐私边界清晰的功能回退,保持网页任务在不同浏览器中可用。
BotBrowser Team
兼容表能回答“应该测试哪些版本”,却不能保证页面处于安全上下文、用户已授权,或服务器已完成操作。BotBrowser 可在获授权的受控 context 中重复这类浏览器观察,但不会授予权限或证明远程结果。将公开数据与调用前的运行时能力检测结合,并提供保留用户输入的可见备用操作,才能得到可复现且不收集账户内容的决定。
TL;DR
- 使用 MDN Browser Compatibility Data 和相关 W3C/WHATWG 规范选择测试矩阵,并记录版本日期。
- 在操作前立即检测能力;属性存在不等于调用一定成功。
- 保留键盘可用的备用路径和已输入数据,说明保真度或安全属性的变化。
- 将浏览器能力、权限、应用确认和服务器结果分别记录。
- BotBrowser 可在受控 context 重复授权的合成流程,但不会授予权限、改变 origin 政策或证明远程事务。
目录
把兼容数据当作证据
支付界面的能力是一个具体例子:Payment Request API:用户同意与安全回退把这套证据模型用于 canMakePayment() 和手动结账。
MDN Browser Compatibility Data 提供版本范围、备注、flag、安全上下文和部分支持信息。阅读备注而不是只看颜色。WHATWG HTML 标准 和 W3C WebAuthn 定义规范条件;MDN 的能力检测指南说明运行时检测比解析 user-agent 更可靠。关于仍处于实验阶段或仅限试验的功能,可参阅源站试验与实验性 Web 平台功能。
为每个 API 记录 origin 和上下文、要检测的方法、权限及异常状态、可见成功信号和回退负责人。方法可能存在,却因权限、策略、取消或缺少激活而拒绝;浏览器 promise 成功也可能早于服务器错误。把这些观察分开保存。
设计能力决策
| 观察 | 决定 | 用户可见结果 | 边界 |
|---|---|---|---|
| 方法和上下文可用 | 尝试一次 | 显示进度和取消 | 浏览器能力 |
| 方法缺失或上下文阻止 | 使用回退 | 保留任务并说明差异 | 兼容性/上下文 |
| 权限拒绝或取消 | 不循环地提供回退 | 保留控制权和输入 | 权限结果 |
| 调用抛错或拒绝 | 分类后停止 | 显示可恢复错误和下一步 | 运行时行为 |
| 调用完成 | 验证应用确认 | 只确认可观察结果 | 浏览器+应用 |
在操作前检测,因为焦点、权限和页面状态会变化。不要解析 user-agent,也不要推断设备。正确的回退应保留任务,并可由键盘和辅助技术访问。
用 fixture 验证回退
下面的 fixture 覆盖方法缺失和 promise 拒绝。只替换 navigator.share(或注入 wrapper),每次重置 DOM,并断言状态和按钮。预期是成功时 completed 且无回退,或 missing/denied/failed 且“复制链接”可用。这验证应用分支,不代表生产支持或服务可用。
async function shareOrCopy() {
const host = document.createElement('div');
host.innerHTML = '<p id="status" role="status"></p><button id="fallback" hidden>复制链接</button>';
document.body.append(host);
const status = host.querySelector('#status');
const fallback = host.querySelector('#fallback');
if (typeof navigator.share !== 'function') {
fallback.hidden = false;
status.textContent = '使用备用操作';
const r = { state: 'missing', action: 'copy-link' };
host.remove();
return r;
}
try {
await navigator.share({ title: '合成项目', url: '/fixture' });
status.textContent = '已分享';
const r = { state: 'completed', action: 'none' };
host.remove();
return r;
} catch (error) {
fallback.hidden = false;
status.textContent = '使用备用操作';
const r = { state: error?.name === 'NotAllowedError' ? 'denied' : 'failed', action: 'copy-link' };
host.remove();
return r;
}
}
可能挂起时加入有界超时,并在 finally 中清理。检查提示、焦点和输入是否保留,不要修改无关浏览器属性。
渐进增强与隐私
先实现基础任务:普通文件 input、可选择 URL、文本地址、语义化表单或摘要通常不依赖可选 API。分享被拒绝时提供复制或邮件,不要隐藏地再次请求;凭据流程取消时保留密码路径。无障碍也是兼容性:给状态合适的 live region,移动焦点并清楚标注操作。只保存 feature、来源版本、上下文、状态、可见结果、回退和日期;不要保存凭据、位置、原始 profile 属性或不必要的截图。
将规则应用到常见 API。
对于 Web Share,缺少方法、没有临时激活或用户取消时,复制链接或打开邮件编辑器仍可完成任务。Clipboard promise 被拒绝可能表示权限策略或焦点丢失;应保留可选择文本并提供明确按钮。Geolocation 的回退可以是手动地址或地图搜索,并区分不安全上下文、拒绝和超时。File System Access 应保留 <input type="file">,说明回退上传的是副本而不是持续文件权限。WebAuthn 要区分不支持的验证器、取消和服务器拒绝,同时保留密码登录。
确定性 fixture 与兼容日志。
fixture 应有合成 origin、明确目的和可见结果。只替换自有测试面,重置 DOM,并使用 /fixture。记录 missing、denied、failed 或 completed,不要把超时归为“不支持”。断言状态、焦点、标签和输入保留;调用成功后如需确认,再查询应用测试 endpoint,并把浏览器观察与应用确认分开。
每个 API 在日志中保留来源及版本、浏览器范围、安全上下文、预期权限、fixture、观察状态、回退和负责人。浏览器发布、策略变化、框架升级或无障碍修复后复核。保存规范化状态,不保存持久标识、凭据、坐标或未脱敏截图。
权限边界、无障碍与决策。
浏览器负责能力和权限观察,传输层负责响应是否到达,应用负责授权和记录含义,存储系统负责保留期限。为每个结论标明对应权威。进行键盘测试:激活主控件,触发缺失或拒绝状态,确认回退控件有可见焦点;状态不能只靠颜色区分。
发布前回答:哪个公开来源选择了该案例?测试了哪项能力和上下文?每种异常对用户显示什么?哪个回退保留任务和输入?谁确认应用结果?未知答案应标记待处理,不要改写成兼容性缺失。
BotBrowser 的能力与限制
BotBrowser 支持在隔离且声明清楚的浏览器 context 中运行授权 fixture,并比较不同版本的可见分支,适用于安全上下文、权限拒绝、promise 拒绝和键盘回退检查;但它不能授予权限、改变 origin 策略或证明远程记录已写入。记录 profile、版本、origin、fixture 版本和可见断言。
它不会把不安全 origin 变安全、授予权限、覆盖系统或嵌入策略,也不保证所有 origin 都有 API。浏览器调用成功不等于服务器保存记录、发送消息或完成业务事务。将 BotBrowser 观察与应用确认并列保存,不要因为能力缺失而修改 profile 或推断身份。
还可阅读 WebDriver BiDi 事件与浏览器自动化 和 Credential Management 登录体验。
结论
用兼容数据选矩阵,用运行时检测选真实路径,用可见回退保留任务。下一步是运行一个具有明确上下文、缺失或拒绝分支、键盘断言及独立应用确认的 fixture。
FAQ
兼容表的绿色单元格是保证吗?
不是。安全上下文、权限、策略、激活和部分支持都可能改变结果。
每个拒绝都应该重试吗?
不应该。分类取消和拒绝,仅在有界且明确的幂等规则下重试。
BotBrowser 能证明远程操作完成吗?
不能。它只证明声明的浏览器观察,远程服务必须确认提交。
兼容记录应包含什么?
功能和来源版本、浏览器版本与上下文、状态和原始异常、可见结果、回退动作及负责人;排除页面私密内容。
来源
本文属于指南: Web 平台能力面:一致性复核地图