1 | # Browserslist [![Cult Of Martians][cult-img]][cult]
|
2 |
|
3 | <img width="120" height="120" alt="Browserslist logo by Anton Lovchikov"
|
4 | src="https://browserslist.github.io/browserslist/logo.svg" align="right">
|
5 |
|
6 | The config to share target browsers and Node.js versions between different
|
7 | front-end tools. It is used in:
|
8 |
|
9 | * [Autoprefixer]
|
10 | * [Babel]
|
11 | * [postcss-preset-env]
|
12 | * [eslint-plugin-compat]
|
13 | * [stylelint-no-unsupported-browser-features]
|
14 | * [postcss-normalize]
|
15 | * [obsolete-webpack-plugin]
|
16 |
|
17 | All tools will find target browsers automatically,
|
18 | when you add the following to `package.json`:
|
19 |
|
20 | ```json
|
21 | "browserslist": [
|
22 | "defaults",
|
23 | "not IE 11",
|
24 | "maintained node versions"
|
25 | ]
|
26 | ```
|
27 |
|
28 | Or in `.browserslistrc` config:
|
29 |
|
30 | ```yaml
|
31 | # Browsers that we support
|
32 |
|
33 | defaults
|
34 | not IE 11
|
35 | maintained node versions
|
36 | ```
|
37 |
|
38 | Developers set their version lists using queries like `last 2 versions`
|
39 | to be free from updating versions manually.
|
40 | Browserslist will use [`caniuse-lite`] with [Can I Use] data for this queries.
|
41 |
|
42 | Browserslist will take queries from tool option,
|
43 | `browserslist` config, `.browserslistrc` config,
|
44 | `browserslist` section in `package.json` or environment variables.
|
45 |
|
46 | [cult-img]: https://cultofmartians.com/assets/badges/badge.svg
|
47 | [cult]: https://cultofmartians.com/done.html
|
48 |
|
49 | <a href="https://evilmartians.com/?utm_source=browserslist">
|
50 | <img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg"
|
51 | alt="Sponsored by Evil Martians" width="236" height="54">
|
52 | </a>
|
53 |
|
54 | [stylelint-no-unsupported-browser-features]: https://github.com/ismay/stylelint-no-unsupported-browser-features
|
55 | [eslint-plugin-compat]: https://github.com/amilajack/eslint-plugin-compat
|
56 | [Browserslist Example]: https://github.com/browserslist/browserslist-example
|
57 | [postcss-preset-env]: https://github.com/jonathantneal/postcss-preset-env
|
58 | [postcss-normalize]: https://github.com/jonathantneal/postcss-normalize
|
59 | [`caniuse-lite`]: https://github.com/ben-eb/caniuse-lite
|
60 | [Autoprefixer]: https://github.com/postcss/autoprefixer
|
61 | [Can I Use]: https://caniuse.com/
|
62 | [Babel]: https://github.com/babel/babel/tree/master/packages/babel-preset-env
|
63 | [obsolete-webpack-plugin]: https://github.com/ElemeFE/obsolete-webpack-plugin
|
64 |
|
65 | ## Docs
|
66 | Read **[full docs](https://github.com/browserslist/browserslist#readme)** on GitHub.
|