browserslist

本博文是翻译:https://github.com/browserslist/browserslist的内容。

Vue-cli官方文档开发模块的浏览器兼容这一块,提到了browserslist,原文如下:

你会发现有 package.json 文件里的 browserslist 字段 (或一个单独的 .browserslistrc 文件),指定了项目的目标浏览器的范围。这个值会被 @babel/preset-envAutoprefixer 用来确定需要转译的 JavaScript 特性和需要添加的 CSS 浏览器前缀。

现在查阅这里了解如何指定浏览器范围。

下面是来自:https://github.com/ai/browserslist的官方文档翻译的内容:

Browserslist

在不同的前端工具之间共享目标浏览器和Node.js版本的配置。它用于:

当您将以下内容添加到package.json文件中时,所有工具都会自动找到目标浏览器:

1
2
3
4
5
6
"browserslist": [
"defaults",
"not IE 11",
"not IE_Mob 11",
"maintained node versions",
]

或者在 .browserslistrc 配置文件中配置:

1
2
3
4
5
6
# Browsers that we support

defaults
not IE 11
not IE_Mob 11
maintained node versions

开发人员在设置版本列表后,比如设置了last 2 version(最后2个版本),可以避免手动更新版本.
Browserslist将从配置文件中去查找:browserslist配置文件,.browserslistrc配置文件,或者package.json文件中的browserslist字段,或者各种环境配置等。
Browserslist Example这个仓库显示了各个工具如何使用Browserslist。

目录

  1. 工具
  2. 最佳实践
  3. 查询指令
  4. 配置文件
  5. 可共享的配置
  6. 不同环境下的配置
  7. 自定义使用数据
  8. JS API
  9. 环境变量
  10. 缓存

工具

  • browserl.ist 是用于检查某些查询将选择哪些浏览器的在线工具.
  • browserslist-ga and browserslist-ga-export download your website browsers statistics to use it in > 0.5% in my stats query.
  • browserslist-useragent-regexp将Browserslist查询编译到RegExp以测试浏览器useragent。
  • browserslist-useragent-ruby是一个Ruby库,用于按用户代理字符串检查浏览器是否与Browserslist相匹配。
  • browserslist-browserstack为Browserslist配置中的所有浏览器运行BrowserStack测试。
  • caniuse-api返回支持某些特定功能的浏览器.
    在项目目录中运行npx browserslist以查看项目的目标浏览器。 此CLI工具是内置的,可在具有Autoprefixer的任何项目中使用.

最佳实践

  • 下面是一个默认查询,它为大多数用户提供了合理的配置:
1
2
3
"browserslist":{
defaults
}
  • 如果要更改我们推荐的默认浏览器集,请将 last 2 versionsnot dead 与使用编号(如 >0.2%)合并。这是因为 last n versions 本身不会添加流行的旧版本,而只使用高于 0.2% 的百分比,从长远来看,会使流行的浏览器更受欢迎。就像我们使用Internet Explorer 6一样,我们可能会陷入垄断和停滞状态。请谨慎使用此设置。
  • 仅当您使用一个浏览器为信息资讯制作网络应用程序时,才直接选择浏览器(最近2个Chrome版本)。 市场上有很多浏览器。 如果您要制作通用的Web应用程序,则应尊重浏览器的多样性。
  • 不要因为不了解浏览器就删除它们。Opera Mini在非洲拥有1亿用户,在全球市场上比微软Edge更受欢迎。中国QQ浏览器的市场份额比Firefox和Safari加起来还要大。

查询指令

Browserslist将使用来自以下来源之一的浏览器和Node.js版本查询:

  • 当前目录或父目录中package.json文件中的browserslist字段配置。 我们建议采用这种方式。
  • .browserslistrc或者browserslist配置文件中配置。
  • BROWSERSLIST环境变量中配置。
  • 如果以上方法未产生有效结果,则Browserslist将使用默认值:>0.5%,last 2 versions,Firefox ESR,not dead.

组合查询

or组合器可以使用关键字or或者使用,,last 1 version or >1%last 1 version , >1%的表示方式是一样的。
and支持查询组合来执行前一个查询的交集:last 1 version and >1%
如下所示,有3种不同的方法来组合查询。首先,您从单个查询开始,然后我们将这些查询组合起来以得到最终的列表:
显然,您不能从not组合器开始,因为没有左侧查询可以将其与之合并。

查询组合器类型 图表表示 示例
or/, combiner (union) 并集 > .5% or last 2 versions / > .5%, last 2 versions
and combiner (intersection) 交集 > .5% and last 2 versions
not combiner (relative complement) not > .5% and not last 2 versions / .5% or not last 2 versions / .5%, not last 2 versions

测试查询的一种快速方法是在终端中执行npx browserslist '> 0.5%, not IE 11'

全部列表

可以通过查询指定浏览器和Node.js版本(不区分大小写):

  • defaults: Browserslist’s default browsers (> 0.5%, last 2 versions, Firefox ESR, not dead).
  • > 5%: browsers versions selected by global usage statistics. >=, < and <= work too.

调试

在终端中运行npx browserslist命令,查看您的查询选择了哪些浏览器:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
and_chr 78
and_ff 68
and_qq 1.2
and_uc 12.12
android 76
baidu 7.12
chrome 79
chrome 78
chrome 77
chrome 49
edge 18
edge 17
firefox 71
firefox 70
firefox 68
ie 11
ie_mob 11
ios_saf 13.3
ios_saf 13.2
ios_saf 13.0-13.1
ios_saf 12.2-12.4
kaios 2.5
op_mini all
op_mob 46
opera 64
opera 63
safari 13
safari 12.1
safari 5.1
samsung 10.1
samsung 9.2

浏览器

名称不区分大小写:

  • Android for Android WebView.
  • Baidu for Baidu Browser.
  • BlackBerry or bb for Blackberry browser.
  • Chrome for Google Chrome.
  • ChromeAndroid or and_chr for Chrome for Android
  • Edge for Microsoft Edge.
  • Electron for Electron framework. It will be converted to Chrome version.
  • Explorer or ie for Internet Explorer.
  • ExplorerMobile or ie_mob for Internet Explorer Mobile.
  • Firefox or ff for Mozilla Firefox.
  • FirefoxAndroid or and_ff for Firefox for Android.
  • iOS or ios_saf for iOS Safari.
  • Node for Node.js.
  • Opera for Opera.
  • OperaMini or op_mini for Opera Mini.
  • OperaMobile or op_mob for Opera Mobile.
  • QQAndroid or and_qq for QQ Browser for Android.
  • Safari for desktop Safari.
  • Samsung for Samsung Internet.
  • UCAndroid or and_uc for UC Browser for Android.
  • kaios for KaiOS Browser.

配置文件

package.json
1
2
3
4
5
6
7
8
9
10
11
{
"private": true,
"dependencies": {
"autoprefixer": "^6.5.4"
},
"browserslist": [
"last 1 version",
"> 1%",
"IE 10"
]
}
.browserslistrc
1
2
3
4
5
# Browsers that we support

last 1 version
> 1%
IE 10 # sorry
liugezhou wechat
欢迎您扫一扫上面的微信公众号,订阅我的博客!
Enjoy Yourself EveryDay!