browserslist 4.6.2 → 4.6.6

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Change Log
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 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.
+
+## 4.6.3
+* Dirty fix for `android all` error.
+
 ## 4.6.2
 * Fix `last x version` and similar queries for Android (by Tony Ross).
 

package/README.md

@@ -14,7 +14,6 @@ front-end tools. It is used in:
 * [postcss-normalize]
 * [obsolete-webpack-plugin]
 
-[Browserslist Example] shows how every tool uses Browserslist.
 All tools will find target browsers automatically,
 when you add the following to `package.json`:
 
@@ -47,6 +46,7 @@ Browserslist will take queries from tool option,
 `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
 [cult]: https://cultofmartians.com/done.html
@@ -67,6 +67,18 @@ You can test Browserslist queries in [online demo].
 [Babel]:                                     https://github.com/babel/babel/tree/master/packages/babel-preset-env
 [obsolete-webpack-plugin]:                   https://github.com/ElemeFE/obsolete-webpack-plugin
 
+## Table of Contents
+
+1. [Tools](#tools)
+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)
+
 ## Tools
 
 * [`browserslist-ga`] downloads your website browsers statistics
@@ -115,7 +127,7 @@ You can test Browserslist queries in [online demo].
 * Don’t remove browsers just because you don’t know them. Opera Mini has
   100 million users in Africa and it is more popular in the global market
   than Microsoft Edge. Chinese QQ Browsers has more market share than Firefox
-  and desktop Safari altogether.
+  and desktop Safari combined.
 
 
 ## Queries
@@ -144,14 +156,14 @@ intersection of the previous query: `last 1 version and > 1%`.
 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 the is no left-hand
+Obviously you can *not* start with a `not` combiner, since there is no left-hand
 side query to combine it with.
 
 | 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'` |
+|`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` |
 
 _A quick way to test your query is to do `npx browserslist '> 0.5%, not IE 11'`
 in your terminal._
@@ -188,10 +200,9 @@ You can specify the browser and Node.js versions by queries (case insensitive):
   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
@@ -200,6 +211,12 @@ You can specify the browser and Node.js versions by queries (case insensitive):
 
 You can add `not ` to any query.
 
+[`caniuse-lite/data/regions`]: https://github.com/ben-eb/caniuse-lite/tree/master/data/regions
+[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
+[Can I Use]:                   https://caniuse.com/
+
 
 ### Debug
 
@@ -225,23 +242,6 @@ samsung 5
 ```
 
 
-### Notes
-
-Browserslist works with separated versions of browsers.
-You should avoid queries like `Firefox > 0`.
-The list of the specified browsers acts as a white list which means other browsers are ignored.
-
-All queries are based on the [Can I Use] support table,
-e.g. `last 3 iOS versions` might select `8.4, 9.2, 9.3` (mixed major and minor),
-whereas `last 3 Chrome versions` might select `50, 49, 48` (major only).
-
-[`caniuse-lite/data/regions`]: https://github.com/ben-eb/caniuse-lite/tree/master/data/regions
-[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
-[Can I Use]:                   https://caniuse.com/
-
-
 ### Browsers
 
 Names are case insensitive:
@@ -269,7 +269,9 @@ Names are case insensitive:
 * `kaios` for KaiOS Browser.
 
 
-## `package.json`
+## Config File
+
+### `package.json`
 
 If you want to reduce config files in project root, you can specify
 browsers in `package.json` with `browserslist` key:
@@ -289,9 +291,9 @@ browsers in `package.json` with `browserslist` key:
 ```
 
 
-## Config File
+### `.browserslistrc`
 
-Browserslist config should be named `.browserslistrc` or `browserslist`
+Separated Browserslist config should be named `.browserslistrc`
 and have browsers queries split by a new line. Comments starts with `#` symbol:
 
 ```yaml
@@ -354,46 +356,7 @@ module.exports = [
 ```
 
 
-## Environment Variables
-
-If some tool use Browserslist inside, you can change browsers settings
-by [environment variables]:
-
-* `BROWSERSLIST` with browsers queries.
-
-   ```sh
-  BROWSERSLIST="> 5%" gulp css
-   ```
-
-* `BROWSERSLIST_CONFIG` with path to config file.
-
-   ```sh
-  BROWSERSLIST_CONFIG=./config/browserslist gulp css
-   ```
-
-* `BROWSERSLIST_ENV` with environments string.
-
-   ```sh
-  BROWSERSLIST_ENV="development" gulp css
-   ```
-
-* `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_DISABLE_CACHE` if you want to disable config reading cache.
-
-   ```sh
-  BROWSERSLIST_DISABLE_CACHE=1 gulp css
-   ```
-
-[environment variables]: https://en.wikipedia.org/wiki/Environment_variable
-
-
-## Environments
+## Configuring for Different Environments
 
 You can also specify different browser queries for various environments.
 Browserslist will choose query according to `BROWSERSLIST_ENV` or `NODE_ENV`
@@ -408,9 +371,12 @@ In `package.json`:
       "> 1%",
       "ie 10"
     ],
-    "development": [
+    "modern": [
       "last 1 chrome version",
       "last 1 firefox version"
+    ],
+    "ssr": [
+      "node 12"
     ]
   }
 ```
@@ -418,13 +384,16 @@ In `package.json`:
 In `.browserslistrc` config:
 
 ```ini
-[production staging]
+[production]
 > 1%
 ie 10
 
-[development]
+[modern]
 last 1 chrome version
 last 1 firefox version
+
+[ssr]
+node 12
 ```
 
 
@@ -507,9 +476,6 @@ For non-JS environment and debug purpose you can use CLI tool:
 browserslist "> 1%, IE 10"
 ```
 
-
-## Coverage
-
 You can get total users coverage for selected browsers by JS API:
 
 ```js
@@ -555,6 +521,45 @@ These browsers account for 83.1% of all users in custom statistics
 ```
 
 
+## Environment Variables
+
+If some tool use Browserslist inside, you can change browsers settings
+by [environment variables]:
+
+* `BROWSERSLIST` with browsers queries.
+
+   ```sh
+  BROWSERSLIST="> 5%" gulp css
+   ```
+
+* `BROWSERSLIST_CONFIG` with path to config file.
+
+   ```sh
+  BROWSERSLIST_CONFIG=./config/browserslist gulp css
+   ```
+
+* `BROWSERSLIST_ENV` with environments string.
+
+   ```sh
+  BROWSERSLIST_ENV="development" gulp css
+   ```
+
+* `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_DISABLE_CACHE` if you want to disable config reading cache.
+
+   ```sh
+  BROWSERSLIST_DISABLE_CACHE=1 gulp css
+   ```
+
+[environment variables]: https://en.wikipedia.org/wiki/Environment_variable
+
+
 ## Cache
 
 Browserslist caches the configuration it reads from `package.json` and

package/index.js

@@ -857,7 +857,7 @@ var QUERIES = [
   {
     regexp: /^(firefox|ff|fx)\s+esr$/i,
     select: function () {
-      return ['firefox 60']
+      return ['firefox 68', 'firefox 60']
     }
   },
   {
@@ -960,7 +960,12 @@ var QUERIES = [
   {
     regexp: /^dead$/i,
     select: function (context) {
-      var dead = ['ie <= 10', 'ie_mob <= 10', 'bb <= 10', 'op_mob <= 12.1']
+      var dead = [
+        'ie <= 10', 'ie_mob <= 10',
+        'bb <= 10',
+        'op_mob <= 12.1',
+        'samsung 4'
+      ]
       return resolve(dead, context)
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "4.6.2",
+  "version": "4.6.6",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -11,9 +11,9 @@
   "license": "MIT",
   "repository": "browserslist/browserslist",
   "dependencies": {
-    "caniuse-lite": "^1.0.30000974",
-    "electron-to-chromium": "^1.3.150",
-    "node-releases": "^1.1.23"
+    "caniuse-lite": "^1.0.30000984",
+    "electron-to-chromium": "^1.3.191",
+    "node-releases": "^1.1.25"
   },
   "bin": "./cli.js",
   "browser": {