I don't understand why we have plugins and extends. What is the difference between them and do I need one or the other?
3 Answers
extends uses a config file which applies set of rules when you add that to the extends options. A plugin on the other hand provides you with a set of rules that you can individually apply depending on your need. Just having a plugin does not enforce any rule. You have to choose which rules you need. A plugin may provide you with zero, one, or more configuration files. If the plugin provides configuration file, then you can load that in your extends section after adding the plugin in the plugins section.
So essentially, plugins given you some rules that have been coded and you can choose which ones are relevant. It may also provide config files to apply rules that the authors think are logically grouped/relevant but providing a config file is not mandatory for a plugin. extends, on the other hand, provides you the ability to apply rules in bulk based on config file specifications.
Example Plugin - eslint-plugin-react
{
"plugins": [
"react"
],
"extends": [
"eslint:recommended",
"plugin:react/recommended"
]
}
Example Config - eslint-config-google
{
"extends": [
"google"
]
}
-
2if i extend a config and it has rule-a, it would automatically be enabled in my config. if i use a plugin, i would have to explicitly enable a rule-b from within that plugin in my rules section. Feb 26, 2019 at 17:39
-
1Worth noting that if you use a plugin that also provides a configuration, you must
extends
it explicitly if you want to use it as well.– QwertyFeb 28, 2020 at 15:22 -
24"after adding the plugin in the plugins section." - Are you sure? I just used
extends: ['plugin:react/recommended']
without adding it toplugins: []
section. Apr 30, 2020 at 16:18 -
3In my opinon this does not fully answer the question which is why there is a follow up question on this topic: stackoverflow.com/questions/61528185/…– wediDec 8, 2020 at 10:30
-
its not needed to add to
plugins
before using inextends
, i can useextends: ['plugin:prettier/recommended']
without add prettier toplugins
Jan 11 at 10:28
In addition to shmit's good answer:
extends
is about extending configurations in general, not only plugins. Potential values are:
"eslint:recommended"
"eslint:all"
- Shareable configuration from npm package (
eslint-config-xxx
or scoped name) - Plugin configuration from npm package (
eslint-plugin-xxx
or scoped name) - Another configuration file, like
"./my/path/.eslintrc.js"
Plugin notation: plugin:<package name>/<configuration name>
, e.g. for eslint-plugin-react
:
"extends": ["plugin:react/recommended"]
By extending from a plugin config, we can get recommended rules without adding them manually.
plugins
A plugin is a special eslint npm package, that provides additional rule definitions (rules
), environments
, processors
and configs
for different configurations of recommended / default rule values.
The plugins
property in .eslintrc.js
is merely a flag to enable a given plugin after installation with npm i
. We now can refer to the plugin's rules, but have to set all rules
values manually.
Think of plugins
as a way to activate a plugin - to use its rules, you need to add the plugin once in the chain in every case.
plugins
is not needed in your own config, if it is already defined in a configuration, that you extend from by extends
.
Example:
eslint-plugin-react
already contains plugins: [ 'react' ]
, hence this entry is not needed anymore in own config and plugin rules can be used directly.
-
2To be clear, if you use
extends
property you don't have to useplugins
property. But if you want to set custom rules then you should useplugins
property. Is it right? Aug 4, 2020 at 10:51 -
1To use rules from a certain plugin, you need to mention this plugin under
plugins
in every case (think ofplugins
as a way to activate a plugin). Though you don't needplugins
in your own config, if it is already defined in a configuration, that you extend from byextends
. See theeslint-plugin-react
plugin example above that already containsplugins: [ 'react' ],
.– ford04Aug 4, 2020 at 11:06 -
If I
npm install eslint-plugin-react
and wish to use its configuration in my owneslintrc.js
, I must first defineplugins: [ 'react' ]
in order to thenextends: [ 'plugin:react/recommended' ]
- so I DO need the plugin stated in my own config. Have you been describing a more specific case: if I extend a different plugin that itself useseslint-plugin-react
- i.e.:eslint-plugin-using-react
, I wouldn't also need to activate the react plugin in my own config, because I've already gotplugins: [ plugin-using-react]
andextends: [plugin:using-react/recommended]
in my config? Jun 11, 2021 at 16:13 -
eslint-plugin-react
works fine for me without having to include it inplugins
. I just addextends: [ 'plugin:react/recommended' ]
, that's it. If I want to override a rule I then userules: { 'react/react-in-jsx-scope': 'off' }
so I really don't understand whyplugins
is even needed. May 16, 2022 at 12:09
So found out that plugins add extra capabilities and extends gives you a baseline on which to add your own custom rules. Thanks to my friend Oliver for helping me answer this question!