browserslist 定义了一套浏览器兼容配置标准,可以让众多前端开发工具之间可以共享一套配置。
支持的前端开发工具列表:
- Autoprefixer
- Babel
- postcss-preset-env
- eslint-plugin-compat
- stylelint-no-unsupported-browser-features
- postcss-normalize
- obsolete-webpack-plugin
- browserslit-ga 和 browserslist-ga-export : 该工具能生成访问你运营的网站的浏览器的版本分布数据,以便用于类似
0.5% in my stats
查询条件,前提是你运营的网站部署有 Google Analytics。 - browserslist-useragent-regexp : 将 browserslist 查询编译为 regexp 以测试浏览器 useragent。可以用于展示“暂不支持你的浏览器”等信息。
- browserslist-useragent-ruby : 功能同上,是一个 Ruby 库。
- caniuse-api :请求 caniuse 数据检查浏览器的兼容性。
npx browserslist
: 在前端工程目录下运行此命令,可以输出当前工程的目标浏览器列表。
browserslist 配置文件和查询顺序
- 工具自身的配置,例如 Autoprefixer 工具配置中的 browsers 属性
- 当前目录或者上级目录的
package.json
配置文件里面的browserslist
配置项(推荐) - 当前目录或者上级目录的
.browserslistrc
配置文件 - 当前目录或者上级目录的
browserslist
配置文件 BROWSERSLIST
环境变量- 如果以上配置均不能提供一个有效的配置,browserslist 将采用默认配置:
> 0.5%, last 2 versions, Firefox ESR, not dead
// package.json
// 默认配置:> 0.5%, last 2 versions, Firefox ESR, not dead
"browserslist": ["defaults"]
配置区分环境
browserslist 可以通过
BROWSERSLIST_ENV
或者 NODE_ENV
选择使用哪些配置,如果这两个环境变量都没指定,那就首先看一下有没有 production
这个环境配置,如果 production
环境也没有,就直接使用 defaults
配置。例如
package.json
中:"browserslist": {
"production": [
"> 1%",
"ie 10"
],
"modern": [
"last 1 chrome version",
"last 1 firefox version"
],
"ssr": [
"node 12"
]
}
在
.browserslistrc
中:[production]
> 1%
ie 10[modern]
last 1 chrome version
last 1 firefox version[ssr]
node 12
具体参数 browserslist 的配置内容可以理解为一个查询集合,根据这个集合来定制我们项目的兼容范围
defaults
: 默认支持的浏览器 (> 0.5%, last 2 versions, Firefox ESR, not dead
)- 统计范围相关
> 5%
: 兼容全球浏览器使用数量占比 5% 以上的类型。数值可以根据实际场景自定义,同理,除了>
也支持>=
、<
、<=
。> 5% in US
:指定国家使用率覆盖(双字母构成,例如CH
、JP
等等)> 5% in alt-AS
: 指定大洲的使用覆盖率(双字母后缀,例如alt-af
、alt-as
等等)> 5% in my stats
: 自己网站的使用覆盖率,需要结合browserslist-ga-export
cover 99.5%
: 覆盖全球 99.5% 的浏览器类型,即支持绝大多数的现代浏览器。cover 99.5% in US
: 与前面同理。cover 99.5% in my stats
: 与前面同理。
- 【认识|认识 browserslist】最近版本
last 2 versions
: 每个浏览器支持的最新 2 个版本last 2 Chrome versions
: Chrome 浏览器支持的最新 2 个版本last 2 major versions
: 每个浏览器支持的最新 2 个主分支版本
- Node 版本
maintained node versions
: 兼容所有仍被支持的 NODE 版本node 10 and node 10.4
: 兼容10.x.x
或10.4.x
版本current node
: 兼容当前环境下的 NODE 版本
- 浏览器版本
ie 6-8
: 设置兼容 IE 版本范围not ie <= 8
: 设置不支持的 IE 版本范围Firefox > 20
: 设置火狐的版本范围,同理也支持>=
、<
及<=
。Firefox ESR
: 火狐延长支持板的最新版本iOS 7
: 设置支持的 iOS 7 浏览器版本
last 2 years
: 最近 2 年发布的浏览器版本since 2015
: 自 2015 年发布的浏览器版本unreleased versions
或unreleased Chrome versions
:alpha 和 beta 版本extends browserslist-config-mycompany
:从 browserslist-config-mycompany 中继承配置。dead
: 一年内未被官方维护更新的版本,到现在为止是IE 11
,IE_Mob 11
,BlackBerry 10
,BlackBerry 7
,Samsung 4
,OperaMobile 12.1
和所有版本的Baidu
not
取非,例如 not dead
。并且条件可以进行集合操作,通过 or
或 ,
进行并集操作,通过 and
进行交集操作,not
去非包含关系集合。具体查询组合效果可以查看官方文档笔者在某教育公司的第 5 波裁员中拿到 N+1,现在准备求职中,如果贵司有前端相关职位正在招聘,烦请联系笔者,请注明来意哈,感谢阅读。
- wx: qiqihaobenben
- emial: chenfangxu_qixin@163.com
- github: https://github.com/qiqihaobenben