平台2026年10月4日

使用 Web Platform Tests 建立浏览器功能信心

结合 Web Platform Tests、运行时能力检查和应用断言，评估浏览器功能的可靠边界。

文档中心

想直接进入平台文档吗？

这篇文章属于博客内容库。若你要步骤化配置、参考说明和持续更新，请直接进入对应 docs 分区。

浏览平台打开 docs 中心

网页测试连接能力检查和应用结果

Web Platform Tests 在声明条件下提供规范证据，但不保证每个应用流程都能成功。应分开记录规范、共享测试、页面能力检查和用户可见的应用结果。能力存在不代表用户身份或设备类别。

选择 WPT 证据

查看 WPT 仓库和 testharness API。记录测试路径、规范章节、浏览器版本、来源、权限和日期。跳过、试验性或预期失败的测试需要保留备用路径。

结合元数据阅读结果。安全上下文、用户手势或权限策略可能让本地运行不同。复用 fixture 前检查许可证、依赖和清理行为。

运行时能力检查

在调用前检查实际需要的方法，区分缺失、可用、拒绝、失败和完成。属性存在不能证明权限、服务可达或服务器写入成功。

保留用户输入并提供键盘可用的备用操作。记录来源、安全上下文、版本、状态、备用路径和可见结果，不采集无关属性。

决策表

观察	决定	可见结果	边界
声明矩阵中的 WPT 通过	纳入候选	能力检查后尝试	规定条件下的符合性
WPT 跳过或试验性	检查元数据	保留备用路径	测试覆盖
方法缺失或上下文受限	使用备用操作	保留任务	页面能力
调用被拒绝	分类一次	显示恢复操作	浏览器行为
调用完成	验证应用	确认可见信号	浏览器与应用

失败 fixture

fixture 创建自己的控件，只模拟自有 API，检查可见文字，并在所有分支删除节点。不要修改指纹或发送凭据。

async function run() {
  const host = document.createElement('div');
  host.innerHTML = '<p id="status"></p><button id="fallback" hidden>使用备用操作</button>';
  document.body.append(host);
  const status = host.querySelector('#status');
  const fallback = host.querySelector('#fallback');
  try {
    const ok = typeof navigator.share === 'function';
    const result = ok
      ? await navigator
          .share({ title: '合成项目', url: '/fixture' })
          .then(() => 'done')
          .catch(() => 'failed')
      : 'missing';
    status.textContent = result === 'done' ? '已完成' : '请使用备用操作';
    if (result !== 'done') fallback.hidden = false;
    console.assert(status.textContent && (result === 'done' || !fallback.hidden));
    return result;
  } finally {
    host.remove();
  }
}