跳转到内容

平台

Baseline 支持概览

发布于

Baseline 用来判断 Web 平台特性在浏览器中的支持情况,涵盖 API、CSS 属性和 JavaScript 语法。它按七种浏览器与平台组合是否一致支持,将特性分为广泛可用、新近可用、有限可用。「Baseline 2026」收录 2026 年达到「新近可用」的特性,到年底才确定完整名单。

Baseline 由 Chrome 团队发起,由 W3C WebDX Community Group 定义;数据以 web-features npm 包的形式从 web-platform-dx/web-features 仓库发布,MDN、Can I Use、Lighthouse 与 DevTools 读取的都是这份数据。

MDN 的 Baseline 词条规定了判定范围,包括 iOS 和 macOS 版 Safari、Android 和桌面版 Chrome、桌面版 Edge、Android 和桌面版 Firefox。集合之外的浏览器不会改变特性的档位。Samsung Internet、Opera、Android WebView 与微信内置 WebView 都不计入,因此一项「广泛可用」的特性仍可能在嵌入式 WebView 中失效。

档位 判定条件 MDN 徽标
广泛可用 在七款浏览器中各自持续支持至少 30 个月 绿色对勾
新近可用 至少在七款浏览器的最新稳定版中都可用 蓝色对勾并标注年份,例如「Baseline 2022」
有限可用 七款中至少缺一款 灰色叉号

web.dev/baseline 上的 30 个月计时从特性的基准日期(keystone date)开始,Baseline 定义把它定为核心浏览器中最后一个加入支持的那次发布的日期(依据 @mdn/browser-compat-data,并排除标为 partial_implementation 的条目),而不是从年度标签开始。高档还要求基准日期必须早于最新的 Firefox x.0 ESR 发布,所以 Firefox 在某次 ESR 切分后不久才支持的特性可能要等超过 30 个月。不计这一条,2026-02 跨入新近可用的特性在 2028-08 成为广泛可用,2026-11 才跨入的则要等到 2029-05,同属「Baseline 2026」的两项特性晋级时间可以相差 9 个月。

特性还会按跨入「新近可用」的日历年份分组。web.dev 把 Baseline 2024 定义为「2024 年内成为 Baseline 新近可用的全部项目」,对 2025 年沿用同一公式,并把 2026 年描述为「最新且仍在发展中的特性集」。因此 Baseline 2026 不是一份已封闭的清单,它会随浏览器发版持续增长到 2026-12。PWA 特性的 Baseline 状态和各浏览器支持情况见按浏览器,其中也包含 Baseline 未覆盖的浏览器。

构建时可以读取 Baseline 的公开数据。运行时是否支持某项特性,仍需另外检测。

从 web-features 读取特性的 Baseline 状态

链接到“从 web-features 读取特性的 Baseline 状态”一节

web-features 包为每个特性暴露 status,其中 baseline 取值 "high"、"low" 或 false,日期字段 baseline_low_date 与 baseline_high_date,以及以 chrome、chrome_android、edge、firefox、firefox_android、safari、safari_ios 为键、记录最近引入该特性的版本的 support 映射(data.schema.json,github.com)。构建脚本可以据此决定代码路径。

import { features } from 'web-features';
const { status } = features['web-share'];
if (status.baseline === 'high') {
console.log(`广泛可用,自 ${status.baseline_high_date} 起`);
} else if (status.baseline === 'low') {
console.log(`新近可用,自 ${status.baseline_low_date} 起;Firefox ${status.support.firefox ?? '无'}`);
} else {
console.log('有限可用:保留回退路径');
}

按浏览器的细节在 support 映射里;只看 baseline 并不知道七款中缺的是哪一款。

「广泛可用」不保证用户所用的浏览器支持,WebView 也不在判定范围内。页面仍需检测 API,并保留回退。

async function shareOrCopy(url) {
if (!('share' in navigator)) {
await navigator.clipboard.writeText(url); // 没有分享面板:改为复制
return 'copied';
}
await navigator.share({ url });
return 'shared';
}

Baseline 决定回退路径值不值得维护;特性检测决定它是否运行。

Baseline 只衡量浏览器支持。MDN 明确写道,它「不能替代无障碍、可用性、性能、安全性或其他测试」,也可能不反映更旧的设备与版本、定义之外的浏览器(例如操作系统 WebView)以及屏幕阅读器等辅助技术。PWA 的 manifest、安装提示和 WebAPK 行为需要按浏览器、操作系统分别检查,单看档位无法判断这些行为。

web.dev/baseline 列出了展示 Baseline 状态的工具。Chrome DevTools 在 Elements 面板中为 CSS 属性显示状态,Lighthouse 提供「Baseline Features」审计。ESLint CSS 规则、Browserslist 查询、webstatus.dev 仪表盘、VS Code 和 Netlify 扩展也会展示状态。它们读取的是同一份 web-features 数据,工具之间结果不同,原因是包版本不同,判定标准相同。

规范

规范状态
无。