浏览器支持
Docusaurus 允许网站通过 browserslist 配置来定义支持的浏览器列表。
目的
网站需要在向后兼容性和包大小之间取得平衡。由于旧版浏览器不支持现代 API 或语法,因此需要更多代码才能实现相同的功能。
例如,您可以使用可选链语法
const value = obj?.prop?.val;
...但不幸的是,它只被 2020 年之后发布的浏览器版本识别。为了兼容早期浏览器版本,当您为生产环境构建网站时,我们的 JS 加载器会将您的代码转译为更冗长的语法
var _obj, _obj$prop;
const value =
(_obj = obj) === null || _obj === void 0
? void 0
: (_obj$prop = _obj.prop) === null || _obj$prop === void 0
? void 0
: _obj$prop.val;
然而,这会增加所有其他用户的网站加载时间,因为原本 29 个字符的行现在变成了 168 个字符——增加了 6 倍!(实际上会更好,因为使用的名称会更短。)作为一种折衷,JS 加载器只将语法转译到浏览器列表中定义的所有浏览器版本所支持的程度。
默认情况下,浏览器列表通过 package.json
文件以根 browserslist
字段的形式提供。
警告
在旧版浏览器上,编译后的输出将使用不受支持的(过新的)JS 语法,导致 React 初始化失败,最终得到一个只有 HTML/CSS 而没有 JS 的静态网站。
默认值
使用默认经典模板初始化的网站在 package.json
中包含以下内容
package.json
{
"name": "docusaurus",
// ...
"browserslist": {
"production": [">0.5%", "not dead", "not op_mini all"],
"development": [
"last 1 chrome version",
"last 1 firefox version",
"last 1 safari version"
]
}
// ...
}
用自然语言解释,生产环境中支持的浏览器是那些
- 市场份额超过 0.5%;并且
- 在过去 24 个月内有官方支持或更新(与“已淘汰”相对);并且
- 不是 Opera Mini。
而开发中使用的浏览器是
- 最新版本的 Chrome 或 Firefox 或 Safari。
您可以使用 browserslist
CLI “评估”任何配置以获取实际列表
npx browserslist --env="production"
输出是生产环境中所有支持的浏览器。以下是 2022 年 1 月的输出
and_chr 96
and_uc 12.12
chrome 96
chrome 95
chrome 94
edge 96
firefox 95
firefox 94
ie 11
ios_saf 15.2
ios_saf 15.0-15.1
ios_saf 14.5-14.8
ios_saf 14.0-14.4
ios_saf 12.2-12.5
opera 82
opera 81
safari 15.1
safari 14.1
safari 13.1
阅读更多
您可能希望访问 browserslist 文档以获取更多规范,特别是接受的查询值和最佳实践。