browserslist 4.12.2 → 4.13.0

package/CHANGELOG.md

@@ -1,19 +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

@@ -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 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 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

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: { },
@@ -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) {

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')
@@ -237,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']
@@ -337,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.12.2",
+  "version": "4.13.0",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -15,8 +15,8 @@
   "license": "MIT",
   "repository": "browserslist/browserslist",
   "dependencies": {
-    "caniuse-lite": "^1.0.30001088",
-    "electron-to-chromium": "^1.3.483",
+    "caniuse-lite": "^1.0.30001093",
+    "electron-to-chromium": "^1.3.488",
     "escalade": "^3.0.1",
     "node-releases": "^1.1.58"
   },