automattic / eslint-config-target-es
Installs: 7
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 4
Forks: 1
Language:JavaScript
Requires (Dev)
- automattic/jetpack-changelogger: ^3.3.4
README
ESLint shareable config to activate eslint-plugin-es-x checks based on browserslist browser targets and MDN browser compatibility data.
Installation
Generally you'll install this via your package manager, e.g.
npm install --save-dev eslint eslint-plugin-es-x @automattic/eslint-config-target-es
Usage
First, you'll probably want to set up a browserslist configuration.
Then you can use this like any other sharable config in your .eslintrc.*
file. Three configurations are offered.
To check only for language features, such as nullish coalescing, your eslintrc might look like
{ extends: [ '@automattic/eslint-config-target-es/language' ], }
To check only for builtins, such as Promise, WeakRef, and various features of RegExp, your eslintrc might look like
{ extends: [ '@automattic/eslint-config-target-es/builtins' ], }
To check both, your eslintrc might look like
{ extends: [ '@automattic/eslint-config-target-es/all' ], }
For least surprise, omitting any suffix is the same as /all
.
Checking built files
If you want to check your built files to make sure you didn't omit transpiling any packages that need transpiling, you might create a validate-es.config.js
like this
module.exports = { root: true, extends: [ '@automattic/eslint-config-target-es/language' ], env: { // Whatever environments you need. }, };
and then run eslint like
eslint --no-eslintrc --no-inline-config --config validate-es.config.js --no-ignore build/
to avoid your standard eslintrc and eslintignore and to avoid errors from any inline directives.
Advanced usage
You can import or require @automattic/eslint-config-target-es/functions
to gain access to some functions that can be used to build your own configuration.
As browserslist and MDN use different browser codes, getAllBrowsers( { query: } )
will take a browserslist query and return an object with the MDN browser codes and the matched versions for each.
getRules( { query:, builtins: } )
will return the rules config. Set builtins
true for "builtins", false for "language", or null/undefined for "all".
Caveats
Some browsers supported by browserslist are not availble in the MDN data (e.g. Opera Mini) or are no longer being updated (e.g. Internet Explorer). In cases like these where no data is available, features are assumed to be supported. Set the environment variable DEBUG=@automattic/eslint-config-target-es:warn
to generate messages when this happens.
Security
Need to report a security vulnerability? Go to https://automattic.com/security/ or directly to our security bug bounty site https://hackerone.com/automattic.
License
eslint-config-target-es is licensed under GNU General Public License v2 (or later)
--