返回知识中心
平台

浏览器 API 兼容数据与功能回退

结合公开兼容数据、运行时检测和隐私边界清晰的功能回退,保持网页任务在不同浏览器中可用。

BotBrowser Team

文档中心

想直接进入 平台 文档吗?

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

兼容表能回答“应该测试哪些版本”,却不能保证页面处于安全上下文、用户已授权,或服务器已完成操作。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 能证明远程操作完成吗?

不能。它只证明声明的浏览器观察,远程服务必须确认提交。

兼容记录应包含什么?

功能和来源版本、浏览器版本与上下文、状态和原始异常、可见结果、回退动作及负责人;排除页面私密内容。

来源

#浏览器 API#兼容数据#能力检测#渐进增强#功能回退

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

在 BotBrowser 里跑一遍同样的检查

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