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文件中时,所有工具都会自动找到目标浏览器:

  "browserslist": [
    "defaults",
    "not IE 11",
    "not IE_Mob 11",
    "maintained node versions",
  ]

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

# 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的任何项目中使用.

最佳实践

  • 下面是一个默认查询,它为大多数用户提供了合理的配置:
"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命令,查看您的查询选择了哪些浏览器:

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
{
  "private": true,
  "dependencies": {
    "autoprefixer": "^6.5.4"
  },
  "browserslist": [
    "last 1 version",
    "> 1%",
    "IE 10"
  ]
}
.browserslistrc
# Browsers that we support

last 1 version
> 1%
IE 10 # sorry
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,456评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,370评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,337评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,583评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,596评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,572评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,936评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,595评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,850评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,371评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,951评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2 342

推荐阅读更多精彩内容

  • 前言 最近在看create-react-app,刚好把browserslist的资料整理下来。一方面督促自己多写博...
    solfKwolf阅读 94,190评论 8 21
  • 请移步到我的Blog,获得更好的阅读体验!本文的链接请点这里 browserlist是什么? browserlis...
    EickL阅读 5,856评论 0 1
  • 一切故事都有始有终, 只不过是, 有人半路结束了, 有人到终点才结束。
    白茶清欢心依旧阅读 193评论 0 0
  • 时间:2017.4.26 累积天数:2天 学习方法:137累积 读经人员:胡妈妈、含含、皮皮、我 读经内容:《...
    符燕妮阅读 218评论 0 0
  • 车上放着两人份的大米和油,算起来有六十公斤,相当于一人了,下坡的路上,车明显往向前冲的力道大了些。路口等红灯时,我...
    野丧阅读 207评论 0 0