browserslist 3.2.5 → 3.2.6

package/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Change Log
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 3.2.6
+* Add Opera Mini 12 to dead browsers.
+* Update docs (by Jamie Kyle).
+
 ## 3.2.5
 * Fix excluding Opera Mini and other browsers with `all` version.
 

package/README.md

@@ -22,7 +22,7 @@ when you add the following to `package.json`:
 {
   "browserslist": [
     "> 1%",
-    "last 2 versions"
+    "IE 10"
   ]
 }
 ```
@@ -33,7 +33,6 @@ Or in `.browserslistrc` config:
 # Browsers that we support
 
 > 1%
-Last 2 versions
 IE 10 # sorry
 ```
 
@@ -95,10 +94,27 @@ Browserslist will use browsers query from one of this sources:
    Browserslist will use defaults:
    `> 0.5%, last 2 versions, Firefox ESR, not dead`.
 
+
+### Best Practices
+
+* We do not recommend to changing the default set of browsers unless you
+  know what are you doing. Browserslist’s default browsers selection is a
+  result of many long discussions. It is easy to make mistake selecting own
+  browsers without understanding what are you doing (like accidentally making
+  your website inaccessible for Chinese users).
+* Select browsers directly (`last 2 Chrome versions`) only if you are making
+  web app for kiosk with one browser. There are a lot browsers on the market.
+  If you are making general web app you should respect browsers diversity.
+* If you want to change the default set of browsers we recommend `> 0.2%`,
+  `> 1% in US` or `> 1% in my stats`. `last 2 versions` will add too many
+  dead browsers and will not add many popular versions. If you require last
+  2 versions support, set `last 2 versions, > 1% in my stats, not dead`.
+
+
+### Full List
+
 You can specify the versions by queries (case insensitive):
 
-* `last 2 versions`: the last 2 versions for each browser.
-* `last 2 Chrome versions`: the last 2 versions of Chrome browser.
 * `> 5%`: versions selected by global usage statistics.
   `>=`, `<` and `<=` work too.
 * `> 5% in US`: uses USA usage statistics. It accepts [two-letter country code].
@@ -124,7 +140,9 @@ You can specify the versions by queries (case insensitive):
 * `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`,
-  and `BlackBerry 7`.
+  `BlackBerry 7`, 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
   (`> 0.5%, last 2 versions, Firefox ESR, not dead`).
 * `not ie <= 8`: exclude browsers selected by previous queries.
@@ -212,7 +230,7 @@ browsers in `package.json` with `browserslist` key:
   },
   "browserslist": [
     "> 1%",
-    "last 2 versions"
+    "IE 10"
   ]
 }
 ```
@@ -227,8 +245,7 @@ and have browsers queries split by a new line. Comments starts with `#` symb
 # Browsers that we support
 
 > 1%
-Last 2 versions
-IE 8 # sorry
+IE 10 # sorry
 ```
 
 Browserslist will check config in every directory in `path`.
@@ -276,8 +293,8 @@ When writing a shared Browserslist package, just export an array.
 
 ```js
 module.exports = [
-  'last 2 versions',
-  'ie 9'
+  '> 1%',
+  'ie 10'
 ]
 ```
 
@@ -333,11 +350,12 @@ In `package.json`:
 ```js
   "browserslist": {
     "production": [
-      "last 2 version",
-      "ie 9"
+      "> 1%",
+      "ie 10"
     ],
     "development": [
-      "last 1 version"
+      "last 1 chrome version",
+      "last 1 firefox version"
     ]
   }
 ```
@@ -346,11 +364,12 @@ In `.browserslistrc` config:
 
 ```ini
 [production staging]
-last 2 version
-ie 9
+> 1%
+ie 10
 
 [development]
-last 1 version
+last 1 chrome version
+last 1 firefox version
 ```
 
 
@@ -405,8 +424,8 @@ var process = function (source, opts) {
 }
 ```
 
-Queries can be a string `"> 5%, last 1 version"`
-or an array `['> 5%', 'last 1 version']`.
+Queries can be a string `"> 1%, IE 10"`
+or an array `['> 1%', 'IE 10']`.
 
 If a query is missing, Browserslist will look for a config file.
 You can provide a `path` option (that can be a file) to find the config file
@@ -426,7 +445,7 @@ Options:
 For non-JS environment and debug purpose you can use CLI tool:
 
 ```sh
-browserslist "> 1%, last 2 versions"
+browserslist "> 1%, IE 10"
 ```
 
 

package/index.js

@@ -710,7 +710,7 @@ var QUERIES = [
   {
     regexp: /^dead$/i,
     select: function () {
-      return ['ie 10', 'ie_mob 10', 'bb 10', 'bb 7']
+      return ['ie 10', 'ie_mob 10', 'bb 10', 'bb 7', 'op_mob 12.1']
     }
   },
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "3.2.5",
+  "version": "3.2.6",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -27,7 +27,7 @@
     "eslint-plugin-node": "^6.0.1",
     "eslint-plugin-promise": "^3.7.0",
     "eslint-plugin-security": "^1.4.0",
-    "eslint-plugin-standard": "^3.0.1",
+    "eslint-plugin-standard": "^3.1.0",
     "fs-extra": "^5.0.0",
     "jest": "^22.4.3",
     "lint-staged": "^7.0.4",