browserslist 4.11.1 → 4.13.0

package/CHANGELOG.md

@@ -1,8 +1,23 @@
 # Change Log
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 4.13
+* Added `supports` query to select browsers (by Jesús Leganés-Combarro).
+
+## 4.12.2
+* Update Firefox ESR.
+
+## 4.12.1
+* Update `package.json` scanning tool for `--update-db` (by Luke Edwards).
+* Improve docs (by Mukundan Senthil).
+* Drop Node.js 13.0-13.6 support because of ES modules bug in that versions.
+
+## 4.12
+* Add environments to shared configs (by Yevgeny Petukhov).
+* Fix docs (by Dmitry Statsenko and Thomas Pozzo di Borgo).
+
 ## 4.11.1
-* FIx Node.js 6 support.
+* Fix Node.js 6 support.
 
 ## 4.11
 * Add `npx browserslist --mobile-to-desktop` (by James Ross).

package/README.md

@@ -17,12 +17,12 @@ front-end tools. It is used in:
 All tools will find target browsers automatically,
 when you add the following to `package.json`:
 
-```js
+```json
   "browserslist": [
     "defaults",
     "not IE 11",
     "not IE_Mob 11",
-    "maintained node versions",
+    "maintained node versions"
   ]
 ```
 
@@ -68,16 +68,24 @@ Browserslist will take queries from tool option,
 
 ## Table of Contents
 
-1. [Tools](#tools)
-2. [Best Practices](#best-practices)
-3. [Queries](#queries)
-4. [Config File](#config-file)
-5. [Shareable Configs](#shareable-configs)
-6. [Configuring for Different Environments](#configuring-for-different-environments)
-7. [Custom Usage Data](#custom-usage-data)
-8. [JS API](#js-api)
-9. [Environment Variables](#environment-variables)
-10. [Cache](#cache)
+* [Tools](#tools)
+* [Best Practices](#best-practices)
+* [Queries](#queries)
+  * [Query Composition](#query-composition)
+  * [Full List](#full-list)
+  * [Debug](#debug)
+  * [Browsers](#browsers)
+* [Config File](#config-file)
+  * [`package.json`](#packagejson)
+  * [`.browserslistrc`](#browserslistrc)
+* [Shareable Configs](#shareable-configs)
+* [Configuring for Different Environments](#configuring-for-different-environments)
+* [Custom Usage Data](#custom-usage-data)
+* [JS API](#js-api)
+* [Environment Variables](#environment-variables)
+* [Cache](#cache)
+* [Security Contact](#security-contact)
+* [For Enterprise](#for-enterprise)
 
 ## Tools
 
@@ -162,18 +170,20 @@ There is 3 different ways to combine queries as depicted below. First you start
 with a single query and then we combine the queries to get our final list.
 
 Obviously you can *not* start with a `not` combiner, since there is no left-hand
-side query to combine it with.
+side query to combine it with. The left-hand is always resolved as `and`
+combiner even if `or` is used (this is an API implementation specificity).
+
+`and` combiner has precedence over `or` combiner.
 
 | Query combiner type | Illustration | Example |
 | ------------------- | :----------: | ------- |
 |`or`/`,` combiner <br> (union) | ![Union of queries](img/union.svg)  | `> .5% or last 2 versions` <br> `> .5%, last 2 versions` |
 | `and` combiner <br> (intersection) | ![intersection of queries](img/intersection.svg) | `> .5% and last 2 versions` |
-| `not` combiner <br> (relative complement) | ![Relative complement of queries](img/complement.svg) | `> .5% and not last 2 versions` <br> `> .5% or not last 2 versions` <br> `> .5%, not last 2 versions` |
+| `not` combiner <br> (relative complement) | ![Relative complement of queries](img/complement.svg) | All those three are equivalent to the first one <br> `> .5% and not last 2 versions` <br> `> .5% or not last 2 versions` <br> `> .5%, not last 2 versions` |
 
 _A quick way to test your query is to do `npx browserslist '> 0.5%, not IE 11'`
 in your terminal._
 
-
 ### Full List
 
 You can specify the browser and Node.js versions by queries (case insensitive):
@@ -182,45 +192,51 @@ You can specify the browser and Node.js versions by queries (case insensitive):
   (`> 0.5%, last 2 versions, Firefox ESR, not dead`).
 * `> 5%`: browsers versions selected by global usage statistics.
   `>=`, `<` and `<=` work too.
-* `> 5% in US`: uses USA usage statistics. It accepts [two-letter country code].
-* `> 5% in alt-AS`: uses Asia region usage statistics. List of all region codes
-  can be found at [`caniuse-lite/data/regions`].
-* `> 5% in my stats`: uses [custom usage data].
-* `> 5% in browserslist-config-mycompany stats`: uses [custom usage data]
-  from `browserslist-config-mycompany/browserslist-stats.json`.
-* `cover 99.5%`: most popular browsers that provide coverage.
-* `cover 99.5% in US`: same as above, with [two-letter country code].
-* `cover 99.5% in my stats`: uses [custom usage data].
-* `maintained node versions`: all Node.js versions, which are [still maintained]
-  by Node.js Foundation.
+  * `> 5% in US`: uses USA usage statistics.
+    It accepts [two-letter country code].
+  * `> 5% in alt-AS`: uses Asia region usage statistics.
+    List of all region codes can be found at [`caniuse-lite/data/regions`].
+  * `> 5% in my stats`: uses [custom usage data].
+  * `> 5% in browserslist-config-mycompany stats`: uses [custom usage data]
+    from `browserslist-config-mycompany/browserslist-stats.json`.
+  * `cover 99.5%`: most popular browsers that provide coverage.
+  * `cover 99.5% in US`: same as above, with [two-letter country code].
+  * `cover 99.5% in my stats`: uses [custom usage data].
+* `dead`: browsers without official support or updates for 24 months.
+  Right now it is `IE 10`, `IE_Mob 11`, `BlackBerry 10`, `BlackBerry 7`,
+  `Samsung 4` and `OperaMobile 12.1`.
+* `last 2 versions`: the last 2 versions for *each* browser.
+  * `last 2 Chrome versions`: the last 2 versions of Chrome browser.
+  * `last 2 major versions` or `last 2 iOS major versions`:
+    all minor/patch releases of last 2 major versions.
 * `node 10` and `node 10.4`: selects latest Node.js `10.x.x`
   or `10.4.x` release.
-* `current node`: Node.js version used by Browserslist right now.
+  * `current node`: Node.js version used by Browserslist right now.
+  * `maintained node versions`: all Node.js versions, which are [still maintained]
+    by Node.js Foundation.
+* `iOS 7`: the iOS browser version 7 directly.
+  * `Firefox > 20`: versions of Firefox newer than 20.
+    `>=`, `<` and `<=` work too. It also works with Node.js.
+  * `ie 6-8`: selects an inclusive range of versions.
+  * `Firefox ESR`: the latest [Firefox ESR] version.
+  * `PhantomJS 2.1` and `PhantomJS 1.9`: selects Safari versions similar
+    to PhantomJS runtime.
 * `extends browserslist-config-mycompany`: take queries from
   `browserslist-config-mycompany` npm package.
-* `ie 6-8`: selects an inclusive range of versions.
-* `Firefox > 20`: versions of Firefox newer than 20.
-  `>=`, `<` and `<=` work too. It also works with Node.js.
-* `iOS 7`: the iOS browser version 7 directly.
-* `Firefox ESR`: the latest [Firefox ESR] version.
-* `PhantomJS 2.1` and `PhantomJS 1.9`: selects Safari versions similar
-  to PhantomJS runtime.
-* `unreleased versions` or `unreleased Chrome versions`:
-  alpha and beta versions.
-* `last 2 major versions` or `last 2 iOS major versions`:
-  all minor/patch releases of last 2 major versions.
+* `supports rtcpeerconnection`: browsers with support for specific features.
+  `rtcpeerconnection` here is the `feat` parameter at the URL of the [Can I Use]
+  page. A list of all available features can be found at
+  [`caniuse-lite/data/features`].
 * `since 2015` or `last 2 years`: all versions released since year 2015
   (also `since 2015-03` and `since 2015-03-10`).
-* `dead`: browsers without official support or updates for 24 months.
-  Right now it is `IE 10`, `IE_Mob 10`, `BlackBerry 10`, `BlackBerry 7`,
-  `Samsung 4` and `OperaMobile 12.1`.
-* `last 2 versions`: the last 2 versions for *each* browser.
-* `last 2 Chrome versions`: the last 2 versions of Chrome browser.
+* `unreleased versions` or `unreleased Chrome versions`:
+  alpha and beta versions.
 * `not ie <= 8`: exclude browsers selected by previous queries.
 
 You can add `not ` to any query.
 
 [`caniuse-lite/data/regions`]: https://github.com/ben-eb/caniuse-lite/tree/master/data/regions
+[`caniuse-lite/data/features`]: https://github.com/ben-eb/caniuse-lite/tree/master/data/features
 [two-letter country code]:     https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
 [custom usage data]:           #custom-usage-data
 [still maintained]:            https://github.com/nodejs/Release
@@ -303,7 +319,8 @@ browsers in `package.json` with `browserslist` key:
 ### `.browserslistrc`
 
 Separated Browserslist config should be named `.browserslistrc`
-and have browsers queries split by a new line. Comments starts with `#` symbol:
+and have browsers queries split by a new line.
+Each line is combined with the `or` combiner. Comments starts with `#` symbol:
 
 ```yaml
 # Browsers that we support
@@ -365,8 +382,25 @@ module.exports = [
 ```
 
 You can also include a `browserslist-stats.json` file as part of your shareable
-config at the root and query it using `> 5% in browserslist-config-mycompany stats`.
-It uses the same format as `extends` and the `dangerousExtend` property as above.
+config at the root and query it using
+`> 5% in browserslist-config-mycompany stats`. It uses the same format
+as `extends` and the `dangerousExtend` property as above.
+
+You can export configs for different environments and select environment
+by `BROWSERSLIST_ENV` or `env` option in your tool:
+
+```js
+module.exports = {
+  development: [
+    'last 1 version'
+  ],
+  production: [
+    'last 1 version',
+    '> 1%',
+    'ie 10'
+  ]
+}
+```
 
 
 ## Configuring for Different Environments
@@ -598,3 +632,14 @@ To report a security vulnerability, please use the [Tidelift security contact].
 Tidelift will coordinate the fix and disclosure.
 
 [Tidelift security contact]: https://tidelift.com/security
+
+
+## For Enterprise
+
+Available as part of the Tidelift Subscription.
+
+The maintainers of `browserslist` and thousands of other packages are working
+with Tidelift to deliver commercial support and maintenance for the open source
+dependencies you use to build your applications. Save time, reduce risk,
+and improve code health, while paying the maintainers of the exact dependencies
+you use. [Learn more.](https://tidelift.com/subscription/pkg/npm-browserslist?utm_source=npm-browserslist&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

package/browser.js

@@ -21,10 +21,15 @@ module.exports = {
 
   loadCountry: function loadCountry () {
     throw new BrowserslistError(
-      'Country statistics is not supported ' +
+      'Country statistics are not supported ' +
       'in client-side build of Browserslist')
   },
 
+  loadFeature: function loadFeature () {
+    throw new BrowserslistError(
+      'Supports queries are not available in client-side build of Browserslist')
+  },
+
   currentNode: function currentNode (resolve, context) {
     return resolve(['maintained node versions'], context)[0]
   },

package/index.js

@@ -424,7 +424,8 @@ function browserslist (queries, opts) {
   var context = {
     ignoreUnknownVersions: opts.ignoreUnknownVersions,
     dangerousExtend: opts.dangerousExtend,
-    mobileToDesktop: opts.mobileToDesktop
+    mobileToDesktop: opts.mobileToDesktop,
+    env: opts.env
   }
 
   env.oldDataWarning(browserslist.data)
@@ -504,6 +505,7 @@ function flatten (array) {
 }
 
 // Will be filled by Can I Use data below
+browserslist.cache = { }
 browserslist.data = { }
 browserslist.usage = {
   global: { },
@@ -645,7 +647,7 @@ var QUERIES = [
   {
     regexp: /^last\s+(\d+)\s+electron\s+major\s+versions?$/i,
     select: function (context, versions) {
-      var validVersions = getMajorVersions(Object.keys(e2c).reverse(), versions)
+      var validVersions = getMajorVersions(Object.keys(e2c), versions)
       return validVersions.map(function (i) {
         return 'chrome ' + e2c[i]
       })
@@ -886,6 +888,20 @@ var QUERIES = [
       return result
     }
   },
+  {
+    regexp: /^supports\s+([\w-]+)$/,
+    select: function (context, feature) {
+      env.loadFeature(browserslist.cache, feature)
+      var features = browserslist.cache[feature]
+      return Object.keys(features).reduce(function (result, version) {
+        var flags = features[version]
+        if (flags.indexOf('y') >= 0 || flags.indexOf('a') >= 0) {
+          result.push(version)
+        }
+        return result
+      }, [])
+    }
+  },
   {
     regexp: /^electron\s+([\d.]+)\s*-\s*([\d.]+)$/i,
     select: function (context, from, to) {
@@ -989,7 +1005,7 @@ var QUERIES = [
   {
     regexp: /^(firefox|ff|fx)\s+esr$/i,
     select: function () {
-      return ['firefox 68']
+      return ['firefox 68', 'firefox 78']
     }
   },
   {

package/node.js

@@ -1,3 +1,4 @@
+var feature = require('caniuse-lite/dist/unpacker/feature').default
 var region = require('caniuse-lite/dist/unpacker/region').default
 var path = require('path')
 var fs = require('fs')
@@ -156,12 +157,18 @@ module.exports = {
     if (!context.dangerousExtend) checkExtend(name)
     // eslint-disable-next-line security/detect-non-literal-require
     var queries = require(require.resolve(name, { paths: ['.'] }))
-    if (!Array.isArray(queries)) {
-      throw new BrowserslistError(
-        '`' + name + '` config exports not an array of queries'
-      )
+    if (queries) {
+      if (Array.isArray(queries)) {
+        return queries
+      } else if (typeof queries === 'object') {
+        if (!queries.defaults) queries.defaults = []
+        return pickEnv(queries, context, name)
+      }
     }
-    return queries
+    throw new BrowserslistError(
+      '`' + name + '` config exports not an array of queries' +
+      ' or an object of envs'
+    )
   },
 
   loadStat: function loadStat (context, name, data) {
@@ -231,6 +238,21 @@ module.exports = {
     }
   },
 
+  loadFeature: function loadFeature (features, name) {
+    name = name.replace(/[^\w-]/g, '')
+    if (features[name]) return
+
+    // eslint-disable-next-line security/detect-non-literal-require
+    var compressed = require('caniuse-lite/data/features/' + name + '.js')
+    var stats = feature(compressed).stats
+    features[name] = { }
+    for (var i in stats) {
+      for (var j in stats[i]) {
+        features[name][i + ' ' + j] = stats[i][j]
+      }
+    }
+  },
+
   parseConfig: function parseConfig (string) {
     var result = { defaults: [] }
     var sections = ['defaults']
@@ -331,6 +353,8 @@ module.exports = {
     dataTimeChecked = false
     filenessCache = { }
     configCache = { }
+
+    this.cache = { }
   },
 
   oldDataWarning: function oldDataWarning (agentsObj) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "4.11.1",
+  "version": "4.13.0",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -15,17 +15,17 @@
   "license": "MIT",
   "repository": "browserslist/browserslist",
   "dependencies": {
-    "caniuse-lite": "^1.0.30001038",
-    "electron-to-chromium": "^1.3.390",
-    "node-releases": "^1.1.53",
-    "pkg-up": "^2.0.0"
+    "caniuse-lite": "^1.0.30001093",
+    "electron-to-chromium": "^1.3.488",
+    "escalade": "^3.0.1",
+    "node-releases": "^1.1.58"
+  },
+  "engines": {
+    "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
   },
   "bin": "./cli.js",
   "browser": {
     "./node.js": "./browser.js",
     "path": false
-  },
-  "eslintIgnore": [
-    "test/fixtures"
-  ]
+  }
 }

package/update-db.js

@@ -1,23 +1,25 @@
 var childProcess = require('child_process')
-var pkgUp = require('pkg-up')
+var escalade = require('escalade/sync')
 var path = require('path')
 var fs = require('fs')
 
 var BrowserslistError = require('./error')
 
 function detectLockfile () {
-  var packagePath = pkgUp.sync()
-  if (!packagePath) {
+  var packageDir = escalade('.', function (dir, names) {
+    return names.indexOf('package.json') !== -1 ? dir : ''
+  })
+
+  if (!packageDir) {
     throw new BrowserslistError(
       'Cannot find package.json. ' +
       'Is it a right project to run npx browserslist --update-db?'
     )
   }
 
-  var rootDir = path.dirname(packagePath)
-  var lockfileNpm = path.join(rootDir, 'package-lock.json')
-  var lockfileYarn = path.join(rootDir, 'yarn.lock')
-  var lockfilePnpm = path.join(rootDir, 'pnpm-lock.yaml')
+  var lockfileNpm = path.join(packageDir, 'package-lock.json')
+  var lockfileYarn = path.join(packageDir, 'yarn.lock')
+  var lockfilePnpm = path.join(packageDir, 'pnpm-lock.yaml')
 
   /* istanbul ignore next */
   if (fs.existsSync(lockfilePnpm)) {