eslint-plugin-eslint-plugin v5.4.1
eslint-plugin-eslint-plugin
An ESLint plugin for linting ESLint plugins. Rules written in CJS, ESM, and TypeScript are all supported.
Installation
You'll first need to install ESLint:
npm i eslint --save-dev
Next, install eslint-plugin-eslint-plugin
:
npm install eslint-plugin-eslint-plugin --save-dev
Usage
Here's an example ESLint configuration that:
- Sets
sourceType
toscript
for CJS plugins (most users) (usemodule
for ESM/TypeScript) - Enables the
recommended
configuration - Enables an optional/non-recommended rule
.eslintrc.json
{
"parserOptions": {
"sourceType": "script"
},
"extends": ["plugin:eslint-plugin/recommended"],
"rules": {
"eslint-plugin/require-meta-docs-description": "error"
}
}
eslint.config.js
(requires eslint>=v8.23.0)
const eslintPluginRecommended = require('eslint-plugin-eslint-plugin/configs/recommended');
module.exports = [
eslintPluginRecommended,
{
languageOptions: { sourceType: 'commonjs' },
rules: {
'eslint-plugin/require-meta-docs-description': 'error',
},
},
];
Rules
💼 Configurations enabled in.\
✅ Set in the recommended
configuration.\
🔧 Automatically fixable by the --fix
CLI option.\
💡 Manually fixable by editor suggestions.\
💭 Requires type information.
Rules
Name | Description | 💼 | 🔧 | 💡 | 💭 |
---|---|---|---|---|---|
fixer-return | require fixer functions to return a fix | ✅ | |||
meta-property-ordering | enforce the order of meta properties | 🔧 | |||
no-deprecated-context-methods | disallow usage of deprecated methods on rule context objects | ✅ | 🔧 | ||
no-deprecated-report-api | disallow the version of context.report() with multiple arguments | ✅ | 🔧 | ||
no-missing-message-ids | disallow messageId s that are missing from meta.messages | ✅ | |||
no-missing-placeholders | disallow missing placeholders in rule report messages | ✅ | |||
no-property-in-node | disallow using in to narrow node types instead of looking at properties | 💭 | |||
no-unused-message-ids | disallow unused messageId s in meta.messages | ✅ | |||
no-unused-placeholders | disallow unused placeholders in rule report messages | ✅ | |||
no-useless-token-range | disallow unnecessary calls to sourceCode.getFirstToken() and sourceCode.getLastToken() | ✅ | 🔧 | ||
prefer-message-ids | require using messageId instead of message or desc to report rule violations | ✅ | |||
prefer-object-rule | disallow function-style rules | ✅ | 🔧 | ||
prefer-placeholders | require using placeholders for dynamic report messages | ||||
prefer-replace-text | require using replaceText() instead of replaceTextRange() | ||||
report-message-format | enforce a consistent format for rule report messages | ||||
require-meta-docs-description | require rules to implement a meta.docs.description property with the correct format | ||||
require-meta-docs-url | require rules to implement a meta.docs.url property | 🔧 | |||
require-meta-fixable | require rules to implement a meta.fixable property | ✅ | |||
require-meta-has-suggestions | require suggestable rules to implement a meta.hasSuggestions property | ✅ | 🔧 | ||
require-meta-schema | require rules to implement a meta.schema property | ✅ | 💡 | ||
require-meta-type | require rules to implement a meta.type property | ✅ |
Tests
Name | Description | 💼 | 🔧 | 💡 | 💭 |
---|---|---|---|---|---|
consistent-output | enforce consistent use of output assertions in rule tests | ✅ | |||
no-identical-tests | disallow identical tests | ✅ | 🔧 | ||
no-only-tests | disallow the test case property only | ✅ | 💡 | ||
prefer-output-null | disallow invalid RuleTester test cases where the output matches the code | ✅ | 🔧 | ||
test-case-property-ordering | require the properties of a test case to be placed in a consistent order | 🔧 | |||
test-case-shorthand-strings | enforce consistent usage of shorthand strings for test cases with no options | 🔧 |
Presets
Name | Description | |
---|---|---|
✅ | recommended | enables all recommended rules in this plugin |
rules-recommended | enables all recommended rules that are aimed at linting ESLint rule files | |
tests-recommended | enables all recommended rules that are aimed at linting ESLint test files | |
all | enables all rules in this plugin, excluding those requiring type information | |
all-type-checked | enables all rules in this plugin, including those requiring type information | |
rules | enables all rules that are aimed at linting ESLint rule files | |
tests | enables all rules that are aimed at linting ESLint test files |
Semantic versioning policy
The list of recommended rules will only change in a major release of this plugin. However, new non-recommended rules might be added in a minor release of this plugin. Therefore, using the all
, rules
, and tests
presets is not recommended for production use, because the addition of new rules in a minor release could break your build.
Preset usage
Presets are enabled by adding a line to the extends
list in your config file. For example, to enable the recommended
preset, use:
{
"extends": ["plugin:eslint-plugin/recommended"]
}
Or to apply linting only to the appropriate rule or test files:
{
"overrides": [
{
"files": ["lib/rules/*.{js,ts}"],
"extends": ["plugin:eslint-plugin/rules-recommended"]
},
{
"files": ["tests/lib/rules/*.{js,ts}"],
"extends": ["plugin:eslint-plugin/tests-recommended"]
}
]
}
9 days ago
1 month ago
2 months ago
4 months ago
4 months ago
8 months ago
11 months ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
6 years ago
6 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago