方法论
本站的每一句论断都应当可以追溯:追溯到一份规范、一份厂商文档、一个 browser-compat-data 文件 或一个实测数字。本页定义兼容性表格使用的词汇,列出上游来源,说明条目多久检查一次,公布按国家 视图背后的公式,并划定 OpenPWA 的覆盖边界。
兼容性数据集的每一行描述一个操作系统上的一个浏览器,并且只带五种状态之一:yes、partial、flag、no 或 unknown。
- yes。该特性在所引版本及之后按规范工作。该行记录首个发布它的版本(
version_added)。 - partial。特性可用,但有文档记载的某一部分缺失、与规范不同,或只在部分载体上工作。该行在 备注中记录缺了什么;如果后来的版本补全了实现,也记录那个版本。
- flag。特性只存在于运行时开关、origin trial 或开发者设置之后。普通用户无法使用,因此在下文 的国家可达率加权中按一半支持计算。
- no。该浏览器没有任何正式版本实现该特性,或已将其移除。
- unknown。找不到能够回答这个问题的来源。一行绝不会为了回避写
no而标成unknown;只有 在编辑确实查不到时才标unknown。
状态不是 yes 的行都带一条说明原因的备注。
置信度描述的是一行背后证据的类别,而不是编辑对它的感觉:
- high。该行引用一个原始的 browser-compat-data
文件,并且自动交叉检查(
check-bcd)发现该行与该文件一致:状态类别相同,首个版本相同。 - medium。该行引用厂商文档、发行说明、缺陷跟踪条目或规范,而该特性没有 browser-compat-data 条目,或所引数据与之存在备注中解释过的分歧。
- low。该行是推断得出的:由引擎家族推断(基于 Chromium 的浏览器继承 Chromium 的特性)、由 厂商的意向声明推断,或由编辑在没有已发布文档可引时自己做的测试推断。
一个数据集的置信度,取该特性相关浏览器各行中最低的置信度。交叉检查发现分歧时,该行会被更正, 更正记录在站点变更记录中。
上游数据来源
Section titled “上游数据来源”支持行来自 MDN browser-compat-data、厂商文档与发行说明、W3C、WHATWG 与 WICG 规范,以及仅用于按国家视图的 StatCounter GlobalStats 市场份额。
- browser-compat-data(MDN)。每个
high行都引用mdn/browser-compat-data仓库中它所 依据的那个原始 JSON 文件;部署流水线会在发布构建前重新读取该文件,并逐行比对所有引用它的行。 - MDN Web Docs 参考页,用于 API 形态与行为描述。
- 厂商文档与发行说明:Apple 的 Safari 与 WebKit 发行说明、Chrome 与 Chromium 发行说明及
developer.chrome.com、Mozilla 的 Firefox 发行说明及developer.mozilla.org、Microsoft Edge 文档,以及 Samsung Internet 发行说明。它们支撑medium行与所有平台行为论断。 - 规范:W3C、WHATWG 与 WICG 文档,作为每个数据集的
spec_url,并作为参考条目的来源。 - StatCounter GlobalStats 浏览器市场份额,仅用于按国家视图。当前快照为 2026-05 月份, 覆盖九个区域:全球、巴西、中国、德国、印度、印度尼西亚、日本、尼日利亚与美国。份额四舍五入到 整数百分比,并归并到数据集使用的浏览器家族(Chrome、Safari、Edge、Firefox、Samsung Internet、 Opera、其他)。
- web-platform-tests 目前不是上游。本站没有任何状态来自
wpt.fyi的结果;这一点改变时, 依赖它的行会在备注中注明。
每条条目都带一个最后核验日期,只有编辑对照来源重新检查过才会变动;超过 180 天的条目(事实依赖商店或平台政策的为 90 天)会进入重新核验队列,流水线按每日计划运行。
- 每条条目的 frontmatter 都带
lastVerified日期,显示为页末的「最后核验」。只有编辑对照来源 重新检查过该条目,这个日期才会变动。 - 每次流水线运行都会扫描条目的时效。参考、指南或兼容性条目超过 180 天即进入重新核验队列;
事实依赖商店或平台政策的页面在 90 天后进入队列,以其单独的
policyCheckedAt日期计算, 因为政策文本的变更不会附带发行说明。 - 任何条目发布或重新发布之前,流水线依次要求:所有引用来源可达;所有兼容性行与其引用的 browser-compat-data 文件一致;条目结构对其类型而言完整;中英文版本都存在;一次独立事实核查, 由与起草文本不同的模型逐条对照所引来源阅读,且不得发现矛盾;以及编辑签字放行。任何一步失败 都会扣下发布。没有豁免开关。
- 流水线按每日计划运行。没有符合条件工作的一天,什么也不发布。
- 已发布事实的实质性变更会记录在站点变更记录中,含日期、页面与一行摘要;更正会标注为更正。
按国家视图回答的是「区域 R 中有多大比例的用户能使用特性 F」,按当地用户实际使用的浏览器加权。 它在构建时由兼容性数据集与 StatCounter 份额计算得出;其中没有任何数字是手写的。
对特性 F 与区域 R,其浏览器家族为 b、份额为 s(b):
reach(F, R) = 100 × Σ_b s(b) × contribution(F, b) / Σ_b s(b)其中 contribution(F, b) 是 F 在家族 b 下各支持行状态权重的平均值,权重为 yes = 1、
partial = 0.5、flag = 0.5、no = 0、unknown = 0。没有 F 对应行的家族贡献为 0,
偏向低估。除以份额总和是为了归一化份额表合计不恰好为 100 的区域。
示例:日本(2026-05)为 Safari 49、Chrome 38、Edge 6、Firefox 3、Samsung 1、Opera 1、其他 2。
一个在 Chrome、Edge 与 Samsung Internet 为 yes、在 Safari 为 partial、在 Firefox 为 no 的
特性,得分为 100 × (38 + 6 + 1 + 0.5 × 49) / 100 = 69.5 %。视图四舍五入到整数百分比。
局限:份额是月度快照,不是实时数据;权重是一种约定(部分实现可能毫无用处,也可能接近完整); 同一家族的桌面行与移动行取平均,而不是按设备份额拆分。这个数字是规划辅助,不是测量结果。
- Web 应用清单及其成员;Service Worker 及其生命周期;各平台上的安装;PWA 可触达的设备与平台 能力;存储;推送与通知;对已安装应用重要的性能原语;iOS 与 macOS Safari、Chrome 与 Android、 Edge 与 Windows、Firefox、Samsung Internet 与 ChromeOS 上的平台行为。
- 上述特性的浏览器支持数据集,政策维度(广告网络、支付 SDK、应用商店)作为单独的行记录,各自 带来源。
- 把参考条目串成一项任务的指南,以及关于平台变化的带日期动态文章,每篇都追溯到一手来源。
- 两个语种同等对待:每条条目要么中英文同时发布,要么不发布。
- 没有应用商店、目录、排行或「安装此应用」界面。
- 不做框架或库的对比,不做构建工具基准测试。
- 没有自建设备实验室。状态来自上述上游来源;编辑在设备上观察到某个行为时,条目会说明并给出
浏览器与操作系统版本,而该行的置信度在出现已发布来源之前保持
low。 - 目前没有厂商界面截图;流程页使用示意图代替。加入设备截图时,获得截图的条目会列在变更记录中。
- 不写复述 MDN 的教程。MDN 已经完整记录某个 API 时,条目链接过去,把篇幅用在 MDN 没有说的 事情上:已安装应用的行为、平台差异、政策与实测限制。