# eslint-plugin-eslint-plugin

> An ESLint plugin for linting ESLint plugins

Latest version **7.6.2** (published 2026-08-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install eslint-plugin-eslint-plugin
pnpm add eslint-plugin-eslint-plugin
yarn add eslint-plugin-eslint-plugin
bun add eslint-plugin-eslint-plugin
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 7.6.2 |
| Published | 2026-08-16 |
| First published | 2016-12-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | ^20.19.0 \|\| ^22.13.0 \|\| >=24.0.0 |
| Dependencies | 2 |
| Unpacked size | 311 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 235 |
| Author | Teddy Katz |
| Maintainers | michaeldeboey, eslint-community-bot |
| Keywords | eslint, eslintplugin, eslint-plugin |

## Links

- npm: https://www.npmjs.com/package/eslint-plugin-eslint-plugin
- Repository: https://github.com/eslint-community/eslint-plugin-eslint-plugin
- Homepage: https://github.com/eslint-community/eslint-plugin-eslint-plugin#readme
- Issues: https://github.com/eslint-community/eslint-plugin-eslint-plugin/issues
- npm.io page: https://npm.io/package/eslint-plugin-eslint-plugin

## Dependencies (2)

- [estraverse](https://npm.io/package/estraverse.md) ^5.3.0
- [@eslint-community/eslint-utils](https://npm.io/package/@eslint-community/eslint-utils.md) ^4.4.0

## Alternatives

- [eslint-plugin-sonarjs](https://npm.io/package/eslint-plugin-sonarjs.md) — 2.9M weekly downloads
- [eslint-config-expo](https://npm.io/package/eslint-config-expo.md) — 1.5M weekly downloads
- [@matter/protocol](https://npm.io/package/@matter/protocol.md) — 63.5K weekly downloads
- [@eventcatalog/linter](https://npm.io/package/@eventcatalog/linter.md) — 24.8K weekly downloads
- [@inrupt/eslint-config-base](https://npm.io/package/@inrupt/eslint-config-base.md) — 4.5K weekly downloads

## Recent versions

- 7.6.2 (latest) — 2026-08-16
- 7.6.1 — 2026-08-06
- 7.6.0 — 2026-07-27
- 7.5.0 — 2026-07-16
- 7.4.2 — 2026-07-12
- 7.4.1 — 2026-06-30
- 7.4.0 — 2026-06-01
- 7.3.3 — 2026-05-04
- 7.3.2 — 2026-03-03
- 7.3.1 — 2026-02-13
- 7.3.0 — 2026-01-06
- 7.2.0 — 2025-10-25
- 7.1.0 — 2025-10-23
- 7.0.0 — 2025-08-04
- 6.5.0 — 2025-06-18
- … 78 more at https://npm.io/package/eslint-plugin-eslint-plugin/versions

## README

# eslint-plugin-eslint-plugin ![CI](https://github.com/eslint-community/eslint-plugin-eslint-plugin/workflows/CI/badge.svg) [![NPM version](https://img.shields.io/npm/v/eslint-plugin-eslint-plugin.svg?style=flat)](https://npmjs.org/package/eslint-plugin-eslint-plugin) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org) <!-- omit from toc -->

An ESLint plugin for linting ESLint plugins. Rules written in CJS, ESM, and TypeScript are all supported.

<!-- vscode-markdown-toc -->

- [Installation](#installation)
- [Usage](#usage)
- [Rules](#rules)
  - [Rules](#rules-1)
  - [Tests](#tests)
- [Presets](#presets)
  - [Semantic versioning policy](#semantic-versioning-policy)
  - [Preset usage](#preset-usage)

<!-- vscode-markdown-toc-config
	numbering=false
	autoSave=true
	/vscode-markdown-toc-config -->
<!-- /vscode-markdown-toc -->

## <a name='Installation'></a>Installation

You'll first need to install [ESLint](https://eslint.org):

```sh
npm i eslint --save-dev
```

Next, install `eslint-plugin-eslint-plugin`:

```sh
npm install eslint-plugin-eslint-plugin --save-dev
```

## <a name='Usage'></a>Usage

Here's an example ESLint configuration that:

- Enables the `recommended` configuration
- Enables an optional/non-recommended rule

Note: you might need to set `sourceType` to `module` or `script` depending on your codebase.

```js
// eslint.config.js
import eslintPlugin from 'eslint-plugin-eslint-plugin';

export default [
  eslintPlugin.configs.recommended,
  {
    rules: {
      'eslint-plugin/require-meta-docs-description': 'error',
    },
  },
];
```

## <a name='Rules'></a>Rules

<!-- begin auto-generated rules list -->

💼 [Configurations](https://github.com/eslint-community/eslint-plugin-eslint-plugin#presets) enabled in.\
✅ Set in the `recommended` [configuration](https://github.com/eslint-community/eslint-plugin-eslint-plugin#presets).\
🔧 Automatically fixable by the [`--fix` CLI option](https://eslint.org/docs/user-guide/command-line-interface#--fix).\
💡 Manually fixable by [editor suggestions](https://eslint.org/docs/latest/use/core-concepts#rule-suggestions).\
💭 Requires [type information](https://typescript-eslint.io/linting/typed-linting).

### Rules

| Name                                                                                                 | Description                                                                                | 💼  | 🔧  | 💡  | 💭  |
| :--------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------- | :-- | :-- | :-- | :-- |
| [fixer-return](docs/rules/fixer-return.md)                                                           | require fixer functions to return a fix                                                    | ✅  |     |     |     |
| [meta-property-ordering](docs/rules/meta-property-ordering.md)                                       | enforce the order of meta properties                                                       |     | 🔧  |     |     |
| [no-deprecated-context-methods](docs/rules/no-deprecated-context-methods.md)                         | disallow usage of deprecated methods on rule context objects                               | ✅  | 🔧  |     |     |
| [no-deprecated-report-api](docs/rules/no-deprecated-report-api.md)                                   | disallow the version of `context.report()` with multiple arguments                         | ✅  | 🔧  |     |     |
| [no-incomplete-meta-schema](docs/rules/no-incomplete-meta-schema.md)                                 | require explicit policy choices in rule options schemas                                    |     |     |     |     |
| [no-incorrect-meta-schema](docs/rules/no-incorrect-meta-schema.md)                                   | disallow rule options schema constructs that ESLint ignores                                |     |     |     |     |
| [no-matching-violation-suggest-message-ids](docs/rules/no-matching-violation-suggest-message-ids.md) | require suggestions to have different `messageId` than their parent report                 |     |     |     |     |
| [no-meta-replaced-by](docs/rules/no-meta-replaced-by.md)                                             | disallow using the `meta.replacedBy` rule property                                         | ✅  |     |     |     |
| [no-meta-schema-default](docs/rules/no-meta-schema-default.md)                                       | disallow rules `meta.schema` properties to include defaults                                | ✅  |     |     |     |
| [no-missing-message-ids](docs/rules/no-missing-message-ids.md)                                       | disallow `messageId`s that are missing from `meta.messages`                                | ✅  |     |     |     |
| [no-missing-placeholders](docs/rules/no-missing-placeholders.md)                                     | disallow missing placeholders in rule report messages                                      | ✅  |     |     |     |
| [no-property-in-node](docs/rules/no-property-in-node.md)                                             | disallow using `in` to narrow node types instead of looking at properties                  |     |     |     | 💭  |
| [no-unused-message-ids](docs/rules/no-unused-message-ids.md)                                         | disallow unused `messageId`s in `meta.messages`                                            | ✅  |     |     |     |
| [no-unused-placeholders](docs/rules/no-unused-placeholders.md)                                       | disallow unused placeholders in rule report messages                                       | ✅  |     |     |     |
| [no-useless-token-range](docs/rules/no-useless-token-range.md)                                       | disallow unnecessary calls to `sourceCode.getFirstToken()` and `sourceCode.getLastToken()` | ✅  | 🔧  |     |     |
| [prefer-message-ids](docs/rules/prefer-message-ids.md)                                               | require using `messageId` instead of `message` or `desc` to report rule violations         | ✅  |     |     |     |
| [prefer-object-rule](docs/rules/prefer-object-rule.md)                                               | disallow function-style rules                                                              | ✅  | 🔧  |     |     |
| [prefer-placeholders](docs/rules/prefer-placeholders.md)                                             | require using placeholders for dynamic report messages                                     |     |     |     |     |
| [prefer-replace-text](docs/rules/prefer-replace-text.md)                                             | require using `replaceText()` instead of `replaceTextRange()`                              |     |     |     |     |
| [report-message-format](docs/rules/report-message-format.md)                                         | enforce a consistent format for rule report messages                                       |     |     |     |     |
| [require-meta-default-options](docs/rules/require-meta-default-options.md)                           | require only rules with options to implement a `meta.defaultOptions` property              | ✅  | 🔧  |     |     |
| [require-meta-docs-description](docs/rules/require-meta-docs-description.md)                         | require rules to implement a `meta.docs.description` property with the correct format      |     |     |     |     |
| [require-meta-docs-recommended](docs/rules/require-meta-docs-recommended.md)                         | require rules to implement a `meta.docs.recommended` property                              |     |     | 💡  |     |
| [require-meta-docs-url](docs/rules/require-meta-docs-url.md)                                         | require rules to implement a `meta.docs.url` property                                      |     | 🔧  |     |     |
| [require-meta-fixable](docs/rules/require-meta-fixable.md)                                           | require rules to implement a `meta.fixable` property                                       | ✅  |     |     |     |
| [require-meta-has-suggestions](docs/rules/require-meta-has-suggestions.md)                           | require suggestable rules to implement a `meta.hasSuggestions` property                    | ✅  | 🔧  |     |     |
| [require-meta-languages](docs/rules/require-meta-languages.md)                                       | require rules to implement a `meta.languages` property                                     |     |     |     |     |
| [require-meta-schema](docs/rules/require-meta-schema.md)                                             | require rules to implement a `meta.schema` property                                        | ✅  |     | 💡  |     |
| [require-meta-schema-description](docs/rules/require-meta-schema-description.md)                     | require rules `meta.schema` properties to include descriptions                             | ✅  |     |     |     |
| [require-meta-type](docs/rules/require-meta-type.md)                                                 | require rules to implement a `meta.type` property                                          | ✅  |     |     |     |

### Tests

| Name                                                                       | Description                                                                     | 💼  | 🔧  | 💡  | 💭  |
| :------------------------------------------------------------------------- | :------------------------------------------------------------------------------ | :-- | :-- | :-- | :-- |
| [consistent-output](docs/rules/consistent-output.md)                       | enforce consistent use of `output` assertions in rule tests                     |     |     |     |     |
| [no-identical-tests](docs/rules/no-identical-tests.md)                     | disallow identical tests                                                        | ✅  | 🔧  |     |     |
| [no-only-tests](docs/rules/no-only-tests.md)                               | disallow the test case property `only`                                          | ✅  |     | 💡  |     |
| [prefer-output-null](docs/rules/prefer-output-null.md)                     | disallow invalid RuleTester test cases where the `output` matches the `code`    | ✅  | 🔧  |     |     |
| [require-test-case-name](docs/rules/require-test-case-name.md)             | require test cases to have a `name` property under certain conditions           |     |     |     |     |
| [require-test-error-positions](docs/rules/require-test-error-positions.md) | requires the position of errors to be explicitly stated for all expected errors |     |     |     |     |
| [test-case-property-ordering](docs/rules/test-case-property-ordering.md)   | require the properties of a test case to be placed in a consistent order        |     | 🔧  |     |     |
| [test-case-shorthand-strings](docs/rules/test-case-shorthand-strings.md)   | enforce consistent usage of shorthand strings for test cases with no options    |     | 🔧  |     |     |
| [unique-test-case-names](docs/rules/unique-test-case-names.md)             | enforce that all test cases with names have unique names                        |     |     |     |     |

<!-- end auto-generated rules list -->

## <a name='Presets'></a>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                |

### <a name='Semanticversioningpolicy'></a>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.

### <a name='Presetusage'></a>Preset usage

Example of applying the `recommended` config to all files.

```js
// eslint.config.js
import eslintPlugin from 'eslint-plugin-eslint-plugin';

export default [eslintPlugin.configs.recommended];
```

Or to apply linting only to the appropriate rule or test files:

```js
// eslint.config.js
import eslintPlugin from 'eslint-plugin-eslint-plugin';

export default [
  {
    files: ['lib/rules/*.{js,ts}'],
    ...eslintPlugin.configs['rules-recommended'],
  },
  {
    files: ['tests/lib/rules/*.{js,ts}'],
    ...eslintPlugin.configs['tests-recommended'],
  },
];
```

## <a name='Settings'></a>Settings

You may set the following settings in your `eslint.config.js`

### <a name='ruleTesterConstructors'></a>`ruleTesterConstructors`

The different names allowed for the constructors of the RuleTester. Can
contain both `string` and `RegExp`. A string verifies a full match, while
a `RegExp` uses [`RegExp.prototype.test()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/test).

This settings defaults to `['RuleTester']`.

```js
// eslint.config.js
export default [
  {
    settings: {
      'eslint-plugin': {
        ruleTesterConstructors: [/RuleTester$/, /^createRuleTester/],
      },
    },
  },
];
```

---
_Source: https://npm.io/package/eslint-plugin-eslint-plugin · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._