Browserslist 目标浏览器配置完全指南:查询语法、配置文件与 JS API 实战

原创2026-09-21 12:21:311,418 阅读
文章标签:开发工具

Browserslist 目标浏览器配置完全指南:查询语法、配置文件与 JS API 实战

Browserslist 是前端工程化中的"浏览器目标共享层":你只需在项目里写一份浏览器/Node.js 版本查询配置,Autoprefixer、Babel、postcss-preset-env、eslint-plugin-compat、stylelint-no-unsupported-browser-features 等工具就会自动读取并使用同一份目标清单。本文将以仓库 README.md 为主线,结合 index.js、node.js、cli.js 等源码实现,完整讲解查询语法、配置文件、共享配置、多环境配置、自定义使用数据、JS API 与环境变量,让你既能直接上手,也能理解底层解析原理。

Browserslist 是什么:一份配置,全前端工具共享

Browserslist 的核心定位是"在不同前端工具之间共享目标浏览器与 Node.js 版本"。它被以下主流工具使用:

  • Autoprefixer(自动添加 CSS 前缀)
  • Babel(通过 babel-preset-env 决定转译目标)
  • postcss-preset-env
  • eslint-plugin-compat(检查 API 兼容性)
  • stylelint-no-unsupported-browser-features
  • postcss-normalize
  • obsolete-webpack-plugin

只要你在项目中添加以下配置,这些工具就会自动发现目标浏览器,无需各自重复维护。在 package.json 中:

{
  "browserslist": [
    "defaults and fully supports es6-module",
    "maintained node versions"
  ]
}

或在 .browserslistrc 配置文件中:

# Browsers that we support

defaults and fully supports es6-module
maintained node versions

开发者使用 last 2 versions 这类**查询(query)**来描述目标版本集合,从而免于手工维护不断变化的版本号。Browserslist 内部使用 caniuse-lite](Can I Use 数据的精简打包)来解析这些查询——这一点在源码中有直接体现:[index.js 引入 caniuse-lite/dist/unpacker/agents 获取浏览器代理数据,并将其整理为 browserslist.data、browserslist.usage.global 等内部结构(见 index.js)。

你可以通过在线 Playground(browsersl.ist)快速验证配置效果,也可以直接在本地终端运行 npx browserslist 查看当前项目解析出的目标清单。

browsersl.ist 在线验证网站截图

快速开始:配置的发现顺序与调试命令

五个配置来源(优先级从高到低)

根据 README.md 与 node.js 中 loadConfig 的实现,Browserslist 会按以下顺序寻找查询来源:

  1. .browserslistrc 配置文件(当前目录或上级目录);
  2. package.json 中的 browserslist 键(当前目录或上级目录);
  3. 名为 browserslist 的配置文件(当前目录或上级目录);
  4. BROWSERSLIST 环境变量(在源码 loadConfig 中优先级最高,见 node.js);
  5. 以上均未产生有效结果时,使用默认值:> 0.5%, last 2 versions, Firefox ESR, not dead。

默认值在源码中定义为 browserslist.defaults(见 index.js),并在 prepareQueries 中作为兜底使用(见 index.js)。

调试:npx browserslist

在任何项目目录下运行 npx browserslist,即可看到你的查询最终选中的浏览器及版本(该 CLI 已内置在 Autoprefixer 依赖树中,任何使用 Autoprefixer 的项目都能直接调用)。例如:

$ npx browserslist
and_chr 61
and_ff 56
and_qq 1.2
and_uc 11.4
android 56
baidu 7.12
bb 10
chrome 62
edge 16
firefox 56
ios_saf 11
opera 48
safari 11
samsung 5

快速测试任意查询的组合效果,可以直接把查询作为参数传入:

npx browserslist '> 0.3%, not dead'

查询语法:组合逻辑与完整查询清单

查询组合(Query Composition)

Browserslist 支持三种组合方式:或(union)、与(intersection)、非(relative complement)。

  • or 与逗号 , 等价:last 1 version or > 1% 等同于 last 1 version, > 1%;
  • and 表示对之前所有查询取交集:last 1 version or chrome > 75 and > 1% 将选择(浏览器最后版本 或 Chrome 76 及以后)且 市场份额大于 1% 的浏览器;
  • not 表示相对补集。注意:不能以 not 开头,因为组合运算需要左侧查询,源码 resolve 函数会在首节点为 not 时直接抛错(见 index.js);且左侧始终按 and 组合解析(这是 API 实现细节)。
组合类型 示意图 示例
or/, 组合(并集) 查询并集示意图 > .5% or last 2 versions
> .5%, last 2 versions
and 组合(交集) 查询交集示意图 > .5% and last 2 versions
not 组合(相对补集) 查询相对补集示意图 三者等价:
> .5% and not last 2 versions
> .5% or not last 2 versions
> .5%, not last 2 versions

从源码看,resolve 函数正是按 node.compose 的值(and 或 or)对上一轮结果执行过滤或拼接(见 index.js),而 not 则是对集合做差集。

完整查询清单(不区分大小写)

默认与整体配置

  • defaults:Browserslist 的默认浏览器集,即 > 0.5%, last 2 versions, Firefox ESR, not dead。

按使用统计

  • > 5%:按全球使用统计选择浏览器版本,>=、<、<= 同样可用;
  • > 5% in US:使用美国地区统计,支持两位国家代码(如 US);
  • > 5% in alt-AS:使用地区统计,完整地区代码列表见 caniuse-lite/data/regions;
  • > 5% in my stats:使用自定义使用数据;
  • > 5% in browserslist-config-mycompany stats:使用共享配置包 browserslist-config-mycompany/browserslist-stats.json 中的自定义数据;
  • cover 99.5%:按流行度从高到低累加,选出覆盖 99.5% 用户的最小子集;
  • cover 99.5% in US:同上,限定国家;
  • cover 99.5% in my stats / cover 99.5% in browserslist-config-mycompany stats:使用自定义统计数据。

源码中 coverQuery 会把使用数据按份额降序排列并累加直到达到覆盖率阈值(见 index.js)。

按 Baseline(Web 平台基线)

  • baseline widely available:支持所有"广泛可用"(Widely available)特性的浏览器版本,这些特性已在核心浏览器集中互操作至少 30 个月;
  • baseline newly available:支持所有"新可用"(Newly available)特性的浏览器版本;
  • baseline widely available on YYYY-MM-DD:选择在指定日期支持广泛可用特性集的版本;
  • baseline 2022:选择兼容指定年份结束时全部"新可用"特性的版本;
  • … with downstream:额外包含核心浏览器集之外、基于 Chromium 或 Gecko 版本支持相应 Baseline 特性集的浏览器;
  • … including kaios:在查询中加入 KaiOS(可配合 with downstream 使用)。

Baseline 查询由 baseline-browser-mapping 依赖驱动,源码中的 baseline 查询处理器会组装选项并调用 bbm.getCompatibleVersions(见 index.js)。

最近版本(Last versions)

  • last 2 versions:每种浏览器的最后 2 个版本;
  • last 2 Chrome versions:仅 Chrome 的最后 2 个版本;
  • last 2 major versions 或 last 2 iOS major versions:最近 2 个大版本的所有 minor/patch 版本。

dead

  • dead:官方不再支持或 24 个月无更新的浏览器。目前包括 IE 11、IE_Mob 11、BlackBerry 10、BlackBerry 7、Samsung 4、OperaMobile 12.1 以及所有版本的 Baidu。源码中 dead 查询通过一组内嵌查询解析实现(见 index.js)。

Node.js 版本

  • node 10、node 10.4:选择最新的 Node.js 10.x.x 或 10.4.x 发布版;
  • last 2 node versions:最近 2 个 Node.js 发布版;
  • last 2 node major versions:最近 2 个大版本线的 Node.js 发布版;
  • current node:当前运行 Browserslist 的 Node.js 版本(见 index.js);
  • maintained node versions:所有仍在 Node.js 团队维护期内的版本(源码通过 node-releases 的 release-schedule 数据筛选,见 index.js)。

浏览器版本

  • iOS 7:直接指定 iOS 浏览器版本 7。注意 op_mini 有特殊版本 all(源码见 index.js);
  • Firefox > 20:Firefox 大于 20 的版本,>=、<、<= 同样可用,也适用于 Node.js;
  • ie 6-8:选择包含端点的版本区间;
  • Firefox ESR:最新的 Firefox 扩展支持版本;
  • PhantomJS 2.1 和 PhantomJS 1.9:选择与 PhantomJS 运行时相近的 Safari 版本(源码分别映射为 safari 6 与 safari 5,见 index.js)。

共享配置

  • extends browserslist-config-mycompany:从 npm 包 browserslist-config-mycompany 中获取查询。

按浏览器特性支持(feature support)

下面的 es6、es6-module 是 Can I Use 页面 URL 中的 feat 参数,可用特性完整列表见 caniuse-lite/data/features:

  • fully supports es6:完整支持某特性的浏览器。例如 fully supports css-grid 会排除 Edge 12-15(这些版本标记为部分支持);
  • partially supports es6-module 或 supports es6-module:完整或部分支持某特性的浏览器。例如 partially supports css-grid 会包含 Edge 12-15。

源码中 supports 查询通过 env.loadFeature 加载特性数据,再用 isSupported 判断 y/a 标记(见 index.js 与 index.js)。

其他

  • browserslist config:引用 Browserslist 配置中定义的浏览器,常用于差异化构建(Differential Serving),例如 browserslist config and fully supports es6-module(见 index.js);
  • since 2015 或 last 2 years:自 2015 年以来发布的所有版本(也支持 since 2015-03、since 2015-03-10);
  • unreleased versions 或 unreleased Chrome versions:alpha、beta 等未正式发布版本;
  • not ie <= 8:从之前的查询结果中排除 IE 8 及以下。

任何查询都可以在前面加 not 取反。

语法规范

仓库提供了查询语法的正式定义文件 grammar.w3c-ebnf,采用 W3C EBNF 格式描述完整的查询文法,例如 LastBrowsers ::= 'last' Space+ Digit+ Space+ (BrowserName Space+)? ('major' Space+)? VersionKeyword、BrowserslistQuery ::= QueryAtom ((OrOperator | AndOperator) SingleQuery)* 等。如果你要自行实现解析器或二次开发,这份文件是权威参考。

浏览器名称标识映射

Browserslist 使用 Can I Use 风格的短标识。下表完整映射了浏览器名称、目标设备与标识符:

浏览器名称 桌面端 Android iOS 其他移动端
Android(WebView) Android
Baidu Baidu
BlackBerry BlackBerry bb
Chrome Chrome ChromeAndroid and_chr ↪︎ ios_saf²
Edge Edge ↪︎ and_chr ↪︎ ios_saf²
Electron Electron
Firefox Firefox ff FirefoxAndroid and_ff ↪︎ ios_saf²
Internet Explorer Explorer ie ie_mob
Node.js Node
KaiOS Browser kaios
Opera Opera op_mob¹ ↪︎ ios_saf²
Opera Mini³ OperaMini op_mini
QQ browser and_qq
Safari Safari iOS ios_saf
Samsung Internet Samsung
UC Browser UCAndroid and_uc
  • ↪︎ name 表示该浏览器使用 name 所对应的同一渲染引擎;
  • ¹ Opera Mobile ≈ Chrome Android;
  • ² 所有 iOS 浏览器均使用 WebKit;
  • ³ Opera Mini 有 "Extreme" 与 "High" 两种省流模式,op_mini 针对 "Extreme" 模式,"High" 模式与普通 Opera Mobile 兼容。

源码中浏览器别名(ff→firefox、ios→ios_saf、explorer→ie 等)定义在 index.js,桌面端回退映射(and_chr→chrome、and_ff→firefox、ie_mob→ie、android→chrome)定义在 index.js。

配置文件详解

在 package.json 中配置

如果你想减少项目根目录的配置文件数量,可以使用 browserslist 键:

{
  "private": true,
  "dependencies": {
    "autoprefixer": "^6.5.4"
  },
  "browserslist": ["last 1 version", "> 1%", "not dead"]
}

源码中 parsePackage 负责解析 package.json,并专门检测了拼写错误的 browserlist 键并抛出提示(见 node.js)。

在 .browserslistrc 中配置

独立的 Browserslist 配置文件应命名为 .browserslistrc,查询按换行分隔,每一行用 or 组合,# 开头为注释:

# Browsers that we support

last 1 version
> 1%
not dead # no browsers without security updates

parseConfig 的实现会先剥离 # 注释,再按换行或逗号切分,并支持 <a href="https://link.gitcode.com/i/a76033f79094c0b87ff5887039841609" target="_blank">section] 分区语法(见 [node.js)。

配置查找与冲突检测

Browserslist 会在 path 的每一级目录向上查找配置。因此,如果工具处理 app/styles/main.css,你可以把配置放在项目根目录、app/ 或 app/styles/ 中——源码 eachParent 会从起点逐级向父目录遍历(见 node.js)。

你也可以用 BROWSERSLIST_CONFIG 环境变量直接指定配置文件路径。

此外,findConfigFile 对同一目录下同时存在多个配置文件的情况会直接抛错(见 node.js),例如:

  • 同时存在 browserslist 文件与 package.json(含 browserslist 键);
  • 同时存在 .browserslistrc 与 package.json(含 browserslist 键);
  • 同时存在 .browserslistrc 与 browserslist 文件。

共享配置(Shareable Configs)

通过 extends 查询可以引用另一个包导出的 Browserslist 配置:

{
  "browserslist": [
    "extends browserslist-config-mycompany"
  ]
}

出于安全考虑,外部配置只支持 browserslist-config- 前缀的包;npm 作用域包也支持,即命名为或前缀为 @scope/browserslist-config,例如 @scope/browserslist-config 或 @scope/browserslist-config-mycompany。源码中的 checkExtend 正是做这三项校验:必须匹配前缀模式、包名不允许出现 .、不允许包含 node_modules(见 node.js)。

如果你不接受用户提供的 Browserslist 查询(例如面向最终用户的构建服务),可以关闭该校验:

BROWSERSLIST_DANGEROUS_EXTEND=1 npx vite build

由于 extends 走 npm 的解析机制,你还可以引用包内的特定文件:

{
  "browserslist": [
    "extends browserslist-config-mycompany/desktop",
    "extends browserslist-config-mycompany/mobile"
  ]
}

编写共享配置时,直接导出一个数组即可。例如 browserslist-config-mycompany/index.js:

module.exports = ['last 1 version', '> 1%', 'not dead']

你也可以在共享配置包根目录放一个 browserslist-stats.json,然后通过 > 5% in browserslist-config-mycompany stats 查询它——它使用与 extends 相同的安全校验(dangerousExtend 同样适用)。源码中 loadStat 会按 path.posix.join(name, 'browserslist-stats.json') 解析该文件(见 node.js)。

共享配置还可以导出多环境对象,并通过 BROWSERSLIST_ENV 或工具的 env 选项选择环境:

module.exports = {
  development: ['last 1 version'],
  production: ['last 1 version', '> 1%', 'not dead']
}

如果你不想自己维护配置,也可以直接使用社区流行的共享配置包(如基于 MDN "widely available" 特性集的 browserslist-config-baseline、与 WordPress 支持范围一致的 @wordpress/browserslist-config),并可在 npm 上按 browserslist-config 关键词检索更多配置。

多环境配置(Configuring for Different Environments)

你可以为不同环境指定不同的浏览器查询。Browserslist 按以下优先级选择环境:BROWSERSLIST_ENV 或 NODE_ENV 环境变量(源码 pickEnv 中 opts.env > BROWSERSLIST_ENV > NODE_ENV,见 node.js);若均未声明,则优先使用 production 查询,其次使用 defaults。

在 package.json 中:

{
  "browserslist": {
    "production": [
      "> 1%",
      "not dead"
    ],
    "modern": [
      "last 1 chrome version",
      "last 1 firefox version"
    ],
    "ssr": [
      "node 12"
    ]
  }
}

在 .browserslistrc 中(使用 [section] 分区语法):

[production]
> 1%
not dead

[modern]
last 1 chrome version
last 1 firefox version

[ssr]
node 12

如果你的工具允许,还可以通过 JS API 的 env 选项指定环境;若配置中不存在所选环境且设置了 throwOnMissing: true,则会在 pickEnv 中抛出 Missing config for Browserslist environment ... 错误(见 node.js)。

自定义使用数据(Custom Usage Data)

你可以基于真实业务流量统计而非全球市场份额来查询,也可以两者混用。例如 > 1% in my stats, > 5% in US, > 10% 就是合法的查询。

要使用自定义数据,首先需要把分析平台数据接入 Browserslist:

  • Plausible:使用 browserslist-plausible 从 Plausible 拉取统计并生成 browserslist-stats.json:

    npx browserslist-plausible --host https://plausible.example.org example.org
    
  • Google Analytics:使用 browserslist-ga 从 Google Analytics 拉取统计;browserslist-ga-export 则可在不要求 Google 登录的情况下转换数据。

  • DIY(自行创建):自己编写统计文件,但必须符合统计数据的 schema:

    {
      // 浏览器名称
      "firefox": {
        // 浏览器版本
        "144": 4.3, // 该浏览器/版本组合的流量占比(%)
        "140": 0.2
      }
    }
    

JS API 还暴露了 Stats 类型,用于代码补全与类型安全(类型定义见 index.d.ts):

/** @type {import('browserslist').Stats} */
const browserslistStats = {
  // Browser name
  firefox: {
    // Browser version
    144: 4.3, // % of traffic for this browser/version combination
    140: 0.2
  }
}

上面的示例表示:Firefox 144 占网站流量的 4.3%。查询 Firefox >= 140 的覆盖率将是 4.5%。

使用自定义数据时需要注意:

  1. 浏览器名称与版本必须存在于 Can I Use 数据库中,不存在的条目会被忽略。因此请参考 caniuse-lite 进行数据转换——例如流量报告中 Google Chrome 应写成 chrome,版本 140.0 应写成 140,否则会被忽略;
  2. 所有百分比之和可以小于 100%:Can I Use 中并非所有浏览器/版本组合都存在,且第三方工具会四舍五入百分比,占流量 0.04% 的冷门浏览器可能被报告为 0.0%。

源码中 getStat 会在 opts.stats、BROWSERSLIST_STATS 或 path 目录向上查找的 browserslist-stats.json 中读取统计数据,并对 dataByBrowser 格式做归一化处理(见 node.js)。

JS API 实战

基本调用与选项

const browserslist = require('browserslist')

// Your CSS/JS build tool code
function process(source, opts) {
  const browsers = browserslist(opts.overrideBrowserslist, {
    stats: opts.stats,
    path: opts.file,
    env: opts.env
  })
  // Your code to add features for selected browsers
}

查询可以是字符串 "> 1%, not dead",也可以是数组 <a href="https://link.gitcode.com/i/4110281e57c3c7e87504123a2b01fa7e" target="_blank">'> 1%', 'not dead']。源码 checkQueries 会对非字符串/数组的输入抛错(见 [index.js)。

如果未提供查询,Browserslist 会自动查找配置文件(见 index.js);你可以通过 path 选项(可以是文件路径)指定从何处相对查找配置文件。

Options 完整说明(与 index.d.ts 中的类型定义一致):

  • path:查找配置文件的文件或目录路径,默认 .;
  • env:从配置中使用哪个环境分区,默认 production;
  • stats:自定义使用统计数据;
  • config:手动指定配置文件的路径;
  • ignoreUnknownVersions:直接查询未知版本(如 ie 12)时不抛错,默认 false;
  • dangerousExtend:关闭 extends 查询的安全校验,默认 false;
  • throwOnMissing:指定的环境不存在时抛错,默认 false;
  • mobileToDesktop:当 Can I Use 缺少某移动端版本数据时回退到桌面端浏览器。Can I Use 只收录移动端浏览器的少数最新版本,默认情况下 last 2 and_ff versions 返回 and_ff 90,开启该选项后返回 and_ff 91, and_ff 90。注意该选项可能导致未知版本错误(例如 Can I Use 还没有 and_ff 91 的数据),默认 false。

browserslist.coverage()

返回所选浏览器的市场份额覆盖率:

const browsers = browserslist('> 1% in US')
browserslist.coverage(browsers, 'US') //=> 83.1

覆盖率计算逻辑见 index.js:未提供参数时使用全球数据,'my stats' 时读取自定义统计,国家代码时加载对应地区数据并累加各版本份额。

browserslist.loadConfig()

与 browserslist() 类似,但它返回的是配置中的查询而不是浏览器列表:

browserslist.loadConfig({ path: process.cwd() }) ?? browserslist.defaults

browserslist.defaults

包含默认查询的数组(即 ['> 0.5%', 'last 2 versions', 'Firefox ESR', 'not dead'],见 index.js)。

CLI 与覆盖率输出

非 JS 环境或调试时可以直接使用 CLI:

browserslist "> 1%, not dead"

计算覆盖率:

$ browserslist --coverage "> 1%"
These browsers account for 81.4% of all users globally
$ browserslist --coverage=US "> 1% in US"
These browsers account for 83.1% of all users in the US
$ browserslist --coverage "> 1% in my stats"
These browsers account for 83.1% of all users in custom statistics
$ browserslist --coverage "> 1% in my stats" --stats=./stats.json
These browsers account for 83.1% of all users in custom statistics

CLI 支持的全部参数可在 cli.js 的 USAGE 中查看,包括 --json、--config、--env、--stats、--coverage=US,RU,global(多地区覆盖率)、--mobile-to-desktop、--ignore-unknown-versions 等。--coverage 甚至支持逗号分隔的多个地区/统计来源,按行输出各自的覆盖率(见 cli.js)。

环境变量总览

如果某个工具内部使用了 Browserslist,你可以通过环境变量覆盖其设置:

环境变量 作用 示例
BROWSERSLIST 直接指定浏览器查询 BROWSERSLIST="> 5%" npx vite build
BROWSERSLIST_CONFIG 指定配置文件路径 BROWSERSLIST_CONFIG=./config/browserslist npx vite build
BROWSERSLIST_ENV 指定配置中的环境分区 BROWSERSLIST_ENV="development" npx vite build
BROWSERSLIST_STATS 指定 > 1% in my stats 使用的自定义数据文件路径 BROWSERSLIST_STATS=./config/usage_data.json npx vite build
BROWSERSLIST_DISABLE_CACHE 禁用配置读取缓存 BROWSERSLIST_DISABLE_CACHE=1 npx vite build
BROWSERSLIST_DANGEROUS_EXTEND 关闭共享配置名称安全检查 BROWSERSLIST_DANGEROUS_EXTEND=1 npx vite build
BROWSERSLIST_ROOT_PATH 阻止读取该路径以上的文件 BROWSERSLIST_ROOT_PATH=. npx vite build
BROWSERSLIST_TRACE_WARNING 定位数据库更新警告的来源(打印调用栈) BROWSERSLIST_TRACE_WARNING=1 npx vite build

其中 BROWSERSLIST_ROOT_PATH 在源码 pathInRoot 中生效:当查找路径超出根路径时会终止向上遍历(见 node.js);BROWSERSLIST_TRACE_WARNING 在 oldDataWarning 中打印 console.trace() 帮助定位警告来源(见 node.js)。

缓存机制(Cache)

Browserslist 会在宿主进程运行期间缓存以下内容:

  • 从 package.json 和 browserslist 文件读取的配置;
  • 配置文件是否存在的信息。

清除这些缓存:

browserslist.clearCaches()

clearCaches 会重置统计缓存、配置路径缓存、解析缓存以及查询结果缓存(见 node.js 与 index.js)。

如果想完全禁用缓存,设置 BROWSERSLIST_DISABLE_CACHE 环境变量即可——源码中查询结果缓存与解析缓存都会检查该变量(见 index.js)。查询结果缓存使用有界 Map,最多保留 500 条条目(CACHE_MAX_ENTRIES,见 index.js)。

数据更新与生态工具

Browserslist 依赖的 caniuse-lite 数据需要定期更新,否则查询结果(尤其是 last 2 versions、>1% 这类依赖最新数据的查询)会过时。当数据过期 6 个月以上时,oldDataWarning 会在控制台输出提醒(见 node.js),并提示运行:

npx update-browserslist-db@latest

仓库 package.json 中直接依赖了 caniuse-lite、electron-to-chromium、node-releases、baseline-browser-mapping 与 update-browserslist-db,分别支撑使用统计/特性数据、Electron 版本映射、Node.js 版本数据、Baseline 查询与数据库更新。

围绕 Browserslist 的生态工具还包括:

  • 配置检查:browserslist-lint 检查配置中的常见错误;
  • 数据更新自动化:browserslist-update-action(GitHub Action)自动运行 update-browserslist-db 并提交 PR;
  • 自定义统计接入:browserslist-plausible、browserslist-ga、browserslist-ga-export、browserslist-new-relic;
  • "不支持你的浏览器"提示:browserslist-useragent-regexp 把查询编译成正则表达式以匹配 User-Agent,browserslist-useragent-ruby 是 Ruby 版本;
  • 其他语言移植:browserslist-rs 是 Rust 移植版;
  • 编辑器支持:VS Code、Vim、WebStorm 均有 .browserslistrc 语法高亮插件。

安全与最佳实践

安全

  • 报告安全漏洞请通过 Tidelift 安全联系方式,Tidelift 将协调修复与披露;
  • 共享配置默认强制 browserslist-config- 前缀校验,防止任意代码被 require(见 node.js);在不可信场景下务必保留该校验。

最佳实践

  • 大多数用户使用 defaults 查询即可获得合理配置:

    {
      "browserslist": [
        "defaults"
      ]
    }
    
  • 如果你想调整默认浏览器集合,推荐 last 2 versions, not dead, > 0.2%。原因在于:单独的 last n versions 不会纳入流行的老版本,而仅使用高于 0.2% 的使用率数字长期来看会让流行浏览器更流行,可能重演 IE6 时代的垄断与停滞局面——请谨慎使用该设置;

  • 只有在为单一浏览器的专用设备(如 kiosk 一体机)开发 Web 应用时,才直接指定浏览器(如 last 2 Chrome versions)。市场上浏览器种类繁多,面向大众的 Web 应用应尊重浏览器多样性;

  • 不要因为不了解某些浏览器就把它们移除:Opera Mini 在非洲有 1 亿用户,全球市场份额高于 Microsoft Edge;中国 QQ 浏览器的市场份额超过 Firefox 与桌面 Safari 之和。

通过本文的查询语法、配置文件、共享配置、多环境、自定义统计、JS API、环境变量与缓存机制,你已经可以完整掌控 Browserslist 的配置体系;配合仓库内的 grammar.w3c-ebnf 语法定义、index.js 核心实现、node.js 配置加载逻辑与 cli.js 命令行工具,还能进一步深入源码级原理,为二次开发或构建工具集成打下基础。

登录后查看全文
browserslist