browserslist 4.12.0 → 4.14.0

package/CHANGELOG.md

@@ -1,12 +1,26 @@
 # Change Log
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 4.14
+* Add `BROWSERSLIST_DANGEROUS_EXTEND` support (by Timo Mayer).
+
+## 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"
   ]
 ```
 
@@ -164,7 +164,9 @@ An `or` combiner can use the keyword `or` as well as `,`.
 `last 1 version or > 1%` is equal to `last 1 version, > 1%`.
 
 `and` query combinations are also supported to perform an
-intersection of the previous query: `last 1 version and > 1%`.
+intersection of all the previous queries:
+`last 1 version or chrome > 75 and > 1%` will select
+(`browser last version` or `Chrome since 76`) and `more than 1% marketshare`.
 
 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.
@@ -173,8 +175,6 @@ Obviously you can *not* start with a `not` combiner, since there is no left-hand
 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` |
@@ -184,7 +184,6 @@ combiner even if `or` is used (this is an API implementation specificity).
 _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):
@@ -193,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 es6-module`: browsers with support for specific features.
+  `es6-module` 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 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.
+* `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
@@ -574,32 +579,39 @@ with [environment variables]:
 * `BROWSERSLIST` with browsers queries.
 
    ```sh
-  BROWSERSLIST="> 5%" gulp css
+  BROWSERSLIST="> 5%" npx webpack
    ```
 
 * `BROWSERSLIST_CONFIG` with path to config file.
 
    ```sh
-  BROWSERSLIST_CONFIG=./config/browserslist gulp css
+  BROWSERSLIST_CONFIG=./config/browserslist npx webpack
    ```
 
 * `BROWSERSLIST_ENV` with environments string.
 
    ```sh
-  BROWSERSLIST_ENV="development" gulp css
+  BROWSERSLIST_ENV="development" npx webpack
    ```
 
 * `BROWSERSLIST_STATS` with path to the custom usage data
   for `> 1% in my stats` query.
 
    ```sh
-  BROWSERSLIST_STATS=./config/usage_data.json gulp css
+  BROWSERSLIST_STATS=./config/usage_data.json npx webpack
    ```
 
 * `BROWSERSLIST_DISABLE_CACHE` if you want to disable config reading cache.
 
    ```sh
-  BROWSERSLIST_DISABLE_CACHE=1 gulp css
+  BROWSERSLIST_DISABLE_CACHE=1 npx webpack
+   ```
+
+* `BROWSERSLIST_DANGEROUS_EXTEND` to disable security shareable config
+  name check.
+
+   ```sh
+  BROWSERSLIST_DANGEROUS_EXTEND=1 npx webpack
    ```
 
 [environment variables]: https://en.wikipedia.org/wiki/Environment_variable

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

@@ -505,6 +505,7 @@ function flatten (array) {
 }
 
 // Will be filled by Can I Use data below
+browserslist.cache = { }
 browserslist.data = { }
 browserslist.usage = {
   global: { },
@@ -646,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]
       })
@@ -887,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) {
@@ -990,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')
@@ -152,8 +153,10 @@ function normalizeUsageData (usageData, data) {
 }
 
 module.exports = {
-  loadQueries: function loadQueries (context, name) {
-    if (!context.dangerousExtend) checkExtend(name)
+  loadQueries: function loadQueries (ctx, name) {
+    if (!ctx.dangerousExtend && !process.env.BROWSERSLIST_DANGEROUS_EXTEND) {
+      checkExtend(name)
+    }
     // eslint-disable-next-line security/detect-non-literal-require
     var queries = require(require.resolve(name, { paths: ['.'] }))
     if (queries) {
@@ -161,7 +164,7 @@ module.exports = {
         return queries
       } else if (typeof queries === 'object') {
         if (!queries.defaults) queries.defaults = []
-        return pickEnv(queries, context, name)
+        return pickEnv(queries, ctx, name)
       }
     }
     throw new BrowserslistError(
@@ -170,8 +173,10 @@ module.exports = {
     )
   },
 
-  loadStat: function loadStat (context, name, data) {
-    if (!context.dangerousExtend) checkExtend(name)
+  loadStat: function loadStat (ctx, name, data) {
+    if (!ctx.dangerousExtend && !process.env.BROWSERSLIST_DANGEROUS_EXTEND) {
+      checkExtend(name)
+    }
     // eslint-disable-next-line security/detect-non-literal-require
     var stats = require(
       require.resolve(
@@ -237,6 +242,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']
@@ -337,6 +357,8 @@ module.exports = {
     dataTimeChecked = false
     filenessCache = { }
     configCache = { }
+
+    this.cache = { }
   },
 
   oldDataWarning: function oldDataWarning (agentsObj) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "4.12.0",
+  "version": "4.14.0",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -15,10 +15,13 @@
   "license": "MIT",
   "repository": "browserslist/browserslist",
   "dependencies": {
-    "caniuse-lite": "^1.0.30001043",
-    "electron-to-chromium": "^1.3.413",
-    "node-releases": "^1.1.53",
-    "pkg-up": "^2.0.0"
+    "caniuse-lite": "^1.0.30001111",
+    "electron-to-chromium": "^1.3.523",
+    "escalade": "^3.0.2",
+    "node-releases": "^1.1.60"
+  },
+  "engines": {
+    "node": "^6 || ^7 || ^8 || ^9 || ^10 || ^11 || ^12 || >=13.7"
   },
   "bin": "./cli.js",
   "browser": {

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)) {