browserslist 4.6.4 → 4.7.1

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Change Log
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 4.7.1
+* Improve caching.
+
+## 4.7
+* Add PhantomJS queries.
+* Improve docs (by Dorian Koehring).
+
+## 4.6.6
+* Remove Safari from `dead` query.
+
+## 4.6.5
+* Add Samsung 4 browser to `dead` query.
+* Remove dirty fix for `android all` error.
+
 ## 4.6.4
 * Add Firefox 68 to `Firefox ESR` query.
 

package/README.md

@@ -45,7 +45,6 @@ Browserslist will take queries from tool option,
 `browserslist` config, `.browserslistrc` config,
 `browserslist` section in `package.json` or environment variables.
 
-You can test Browserslist queries in [online demo].
 [Browserslist Example] shows how every tool uses Browserslist.
 
 [cult-img]: https://cultofmartians.com/assets/badges/badge.svg
@@ -62,7 +61,6 @@ You can test Browserslist queries in [online demo].
 [postcss-preset-env]:                        https://github.com/jonathantneal/postcss-preset-env
 [postcss-normalize]:                         https://github.com/jonathantneal/postcss-normalize
 [Autoprefixer]:                              https://github.com/postcss/autoprefixer
-[online demo]:                               https://browserl.ist/
 [Can I Use]:                                 https://caniuse.com/
 [Babel]:                                     https://github.com/babel/babel/tree/master/packages/babel-preset-env
 [obsolete-webpack-plugin]:                   https://github.com/ElemeFE/obsolete-webpack-plugin
@@ -73,16 +71,17 @@ You can test Browserslist queries in [online demo].
 2. [Best Practices](#best-practices)
 3. [Queries](#queries)
 4. [Config File](#config-file)
-5. [Configuring for Different Environments](#configuring-for-different-environments)
-6. [Custom Usage Data](#custom-usage-data)
-7. [JS API](#js-api)
-8. [Environment Variables](#environment-variables)
-9. [Cache](#cache)
+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
 
-* [`browserslist-ga`] downloads your website browsers statistics
-  to use it in `> 0.5% in my stats` query.
+* [`browserslist-ga`] and [`browserslist-ga-export`] download your website
+  browsers statistics to use it in `> 0.5% in my stats` query.
 * [`browserslist-useragent-regexp`] compiles Browserslist query to a RegExp
   to test browser useragent.
 * [`browserslist-useragent-ruby`] is a Ruby library to checks browser
@@ -94,12 +93,13 @@ You can test Browserslist queries in [online demo].
   target browsers. This CLI tool is built-in and available in any project
   with Autoprefixer.
 
+[`browserslist-useragent-regexp`]: https://github.com/browserslist/browserslist-useragent-regexp
 [`browserslist-useragent-ruby`]:   https://github.com/browserslist/browserslist-useragent-ruby
+[`browserslist-browserstack`]:     https://github.com/xeroxinteractive/browserslist-browserstack
+[`browserslist-ga-export`]:        https://github.com/browserslist/browserslist-ga-export
 [`browserslist-useragent`]:        https://github.com/pastelsky/browserslist-useragent
-[`browserslist-useragent-regexp`]: https://github.com/browserslist/browserslist-useragent-regexp
 [`browserslist-ga`]:               https://github.com/browserslist/browserslist-ga
 [`caniuse-api`]:                   https://github.com/Nyalab/caniuse-api
-[`browserslist-browserstack`]:     https://github.com/xeroxinteractive/browserslist-browserstack
 
 
 ## Best Practices
@@ -133,7 +133,7 @@ You can test Browserslist queries in [online demo].
 ## Queries
 
 Browserslist will use browsers and Node.js versions query
-from one of this sources:
+from one of these sources:
 
 1. `browserslist` key in `package.json` file in current or parent directories.
    **We recommend this way.**
@@ -194,16 +194,17 @@ You can specify the browser and Node.js versions by queries (case insensitive):
   `>=`, `<` 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.
 * `since 2015` or `last 2 years`: all versions released since year 2015
   (also `since 2015-03` and `since 2015-03-10`).
-* `dead`: browsers from `last 2 version` query, but with less than 0.5%
-  in global usage statistics and without official support or updates
-  for 24 months. Right now it is `IE 10`, `IE_Mob 10`, `BlackBerry 10`,
-  `BlackBerry 7`, and `OperaMobile 12.1`.
+* `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.
 * `defaults`: Browserslist’s default browsers
@@ -408,8 +409,10 @@ If you have a website, you can query against the usage statistics of your site.
 npx browserslist-ga
 ```
 
-Of course, you can generate usage statistics file by any other method.
-File format should be like:
+Or you can use [`browserslist-ga-export`] to convert Google Analytics data without giving a password for Google account.
+
+You can generate usage statistics file by any other method. File format should
+be like:
 
 ```js
 {
@@ -425,12 +428,13 @@ File format should be like:
 }
 ```
 
-Note that you can query against your custom usage data
-while also querying against global or regional data.
-For example, the query `> 1% in my stats, > 5% in US, 10%` is permitted.
+Note that you can query against your custom usage data while also querying
+against global or regional data. For example, the query
+`> 1% in my stats, > 5% in US, 10%` is permitted.
 
-[`browserslist-ga`]: https://github.com/browserslist/browserslist-ga
-[Can I Use]:         https://caniuse.com/
+[`browserslist-ga-export`]: https://github.com/browserslist/browserslist-ga-export
+[`browserslist-ga`]:        https://github.com/browserslist/browserslist-ga
+[Can I Use]:                https://caniuse.com/
 
 
 ## JS API

package/index.js

@@ -10,10 +10,7 @@ var env = require('./node') // Will load browser.js in webpack
 var FLOAT_RANGE = /^\d+(\.\d+)?(-\d+(\.\d+)?)*$/
 var YEAR = 365.259641 * 24 * 60 * 60 * 1000
 
-// Enum values MUST be powers of 2, so combination are safe
-/** @constant {number} */
 var QUERY_OR = 1
-/** @constant {number} */
 var QUERY_AND = 2
 
 function isVersionsMatch (versionA, versionB) {
@@ -265,14 +262,10 @@ function resolve (queries, context) {
           case QUERY_AND:
             if (isExclude) {
               return result.filter(function (j) {
-                // remove result items that are in array
-                // (the relative complement of array in result)
                 return array.indexOf(j) === -1
               })
             } else {
               return result.filter(function (j) {
-                // remove result items not in array
-                // (intersect of result and array)
                 return array.indexOf(j) !== -1
               })
             }
@@ -287,7 +280,6 @@ function resolve (queries, context) {
                 return !filter[j]
               })
             }
-            // union of result and array
             return result.concat(array)
         }
       }
@@ -375,35 +367,14 @@ function browserslist (queries, opts) {
   return uniq(result)
 }
 
-/**
- * @typedef {object} BrowserslistQuery
- * @property {number} type A type constant like QUERY_OR @see QUERY_OR.
- * @property {string} queryString A query like "not ie < 11".
- */
-
-/**
- * Parse a browserslist string query
- * @param {string} queries One or more queries as a string
- * @returns {BrowserslistQuery[]} An array of BrowserslistQuery
- */
 function parse (queries) {
   var qs = []
-
   do {
     queries = doMatch(queries, qs)
   } while (queries)
-
   return qs
 }
 
-/**
- * Find query matches in a string. This function is meant to be called
- * repeatedly with the returned query string until there is no more matches.
- * @param {string} string A string with one or more queries.
- * @param {BrowserslistQuery[]} qs Out parameter,
- * will be filled with `BrowserslistQuery`.
- * @returns {string} The rest of the query string minus the matched part.
- */
 function doMatch (string, qs) {
   var or = /^(?:,\s*|\s+OR\s+)(.*)/i
   var and = /^\s+AND\s+(.*)/i
@@ -918,6 +889,18 @@ var QUERIES = [
       return resolve(queries, context)
     }
   },
+  {
+    regexp: /^phantomjs\s+1.9$/i,
+    select: function () {
+      return ['safari 5']
+    }
+  },
+  {
+    regexp: /^phantomjs\s+2.1$/i,
+    select: function () {
+      return ['safari 6']
+    }
+  },
   {
     regexp: /^(\w+)\s+(tp|[\d.]+)$/i,
     select: function (context, name, version) {
@@ -957,15 +940,6 @@ var QUERIES = [
       return browserslist(browserslist.defaults)
     }
   },
-  {
-    regexp: /^android all$/i,
-    select: function () {
-      /* istanbul ignore next */
-      console.warn('BrowserslistError: Unknown browser query `android all`')
-      /* istanbul ignore next */
-      return []
-    }
-  },
   {
     regexp: /^dead$/i,
     select: function (context) {
@@ -973,8 +947,6 @@ var QUERIES = [
         'ie <= 10', 'ie_mob <= 10',
         'bb <= 10',
         'op_mob <= 12.1',
-        'safari <= 11',
-        'ios_saf <= 11',
         'samsung 4'
       ]
       return resolve(dead, context)

package/node.js

@@ -42,7 +42,8 @@ function isFile (file) {
 }
 
 function eachParent (file, callback) {
-  var loc = path.resolve(file)
+  var dir = isFile(file) ? path.dirname(file) : file
+  var loc = path.resolve(dir)
   do {
     var result = callback(loc)
     if (typeof result !== 'undefined') return result
@@ -243,7 +244,10 @@ module.exports = {
       return configCache[cacheKey]
     }
 
+    var passed = []
     var resolved = eachParent(from, function (dir) {
+      passed.push(dir)
+
       var config = path.join(dir, 'browserslist')
       var pkg = path.join(dir, 'package.json')
       var rc = path.join(dir, '.browserslistrc')
@@ -277,7 +281,9 @@ module.exports = {
       }
     })
     if (!process.env.BROWSERSLIST_DISABLE_CACHE) {
-      configCache[cacheKey] = resolved
+      passed.forEach(function (dir) {
+        configCache[dir] = resolved
+      })
     }
     return resolved
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "4.6.4",
+  "version": "4.7.1",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -11,13 +11,20 @@
   "license": "MIT",
   "repository": "browserslist/browserslist",
   "dependencies": {
-    "caniuse-lite": "^1.0.30000981",
-    "electron-to-chromium": "^1.3.188",
-    "node-releases": "^1.1.25"
+    "caniuse-lite": "^1.0.30000999",
+    "electron-to-chromium": "^1.3.284",
+    "node-releases": "^1.1.36"
   },
   "bin": "./cli.js",
   "browser": {
     "./node.js": "./browser.js",
     "path": false
+  },
+  "eslintIgnore": [
+    "test/fixtures"
+  ],
+  "sharec": {
+    "config": "@logux/sharec-config",
+    "version": "0.5.4"
   }
 }