Registry / devops / eslint-rspack-plugin

eslint-rspack-plugin

library4.4.1jsnpmunverified

An ESLint plugin for Rspack, forked from eslint-webpack-plugin. Version 4.4.1 is current, with active maintenance and regular releases. It integrates ESLint into the Rspack build process, providing features like caching, config type detection (flat or eslintrc), and support for multiple file extensions. Key differentiators: automatic configType detection based on ESLint version, support for ESLint 8, 9, and 10 (peer dep ^8.0.0 || ^9.0.0 || ^10.0.0), and focused compatibility with Rspack. Alternatives: running ESLint separately via CLI or editor integration.

devops testing

npm install eslint-rspack-plugin

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-RSPACK-PLUG

eslint-rspack-plugin

devopsjavascriptv4.4.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ESLintPlugin

✓ import ESLintPlugin from 'eslint-rspack-plugin';

✗ const ESLintPlugin = require('eslint-rspack-plugin');

Package is ESM-only; CommonJS require() will fail in Node >=16 with ESM config. Use import or dynamic import().

ESLintPluginOptions

✓ import type { ESLintPluginOptions } from 'eslint-rspack-plugin';

✗ import ESLintPluginOptions from 'eslint-rspack-plugin';

ESLintPluginOptions is a TypeScript type, not a runtime export; use type-only import.

default export

✓ import ESLintPlugin from 'eslint-rspack-plugin';

✗ import { ESLintPlugin } from 'eslint-rspack-plugin';

Only a default export is provided; named export { ESLintPlugin } does not exist.

Configures eslint-rspack-plugin in an Rspack config, setting file extensions, exclusion, caching, and flat config type.

import ESLintPlugin from 'eslint-rspack-plugin'; export default { plugins: [ new ESLintPlugin({ extensions: ['js', 'jsx', 'ts', 'tsx'], exclude: 'node_modules', cache: true, eslintPath: 'eslint', configType: 'flat', }), ], };

Debug

Known issues

breakingPlugin is ESM-only. Node.js require() will throw ERR_REQUIRE_ESM.

fix

Convert to ESM (set "type": "module" in package.json or use .mjs extension) and use import syntax.

affects: >=4.0.0

gotchaThe 'configType' option must match the ESLint version: use 'eslintrc' for ESLint <9, 'flat' for ESLint >=9. Autodetection may pick wrong if ESLint version is ambiguous.

fix

Explicitly set configType to match your ESLint configuration format (eslintrc or flat).

affects: >=4.0.0

gotchaThe 'extensions' option only works with configType: 'eslintrc'. For flat config, use ESLint's 'files' option directly.

fix

When using flat config, specify files in ESLint configuration instead of plugin options.

affects: >=4.0.0

deprecatedThe 'lintDirtyModulesOnly' option is deprecated and may be removed in a future version. Use 'lintAllFiles' instead.

fix

Replace lintDirtyModulesOnly with lintAllFiles: true if you want to lint all files.

affects: >=4.2.0

gotchaCache location default changed between versions. v4.4.0+ uses 'node_modules/.cache/eslint-rspack-plugin/.eslintcache'; older versions used a different path.

fix

Clear old cache directory if migrating from an older version, or set cacheLocation explicitly.

affects: <4.4.0

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module /path/to/eslint-rspack-plugin/dist/index.js from /path/to/rspack.config.js not supported.

Using CommonJS require() to import an ESM-only package.

fix

Convert your config file to ESM: rename to .mjs or add "type": "module" in package.json, then use import ESLintPlugin from 'eslint-rspack-plugin';

TypeError: ESLintPlugin is not a constructor

Importing the default export incorrectly, e.g., using a named import.

fix

Use default import: import ESLintPlugin from 'eslint-rspack-plugin';

Configuration for rule 'some-rule' is invalid: Value "error" should be one of 0, 1, 2.

Using string severity ('error') in ESLint configuration when numeric values are expected, common with flat config without proper adapter.

fix

Ensure your ESLint config uses numeric severity (2 for error) or correct format. For flat config, use 'error' as string is valid, but this error appears if mixing formats.

Error: ESLint configuration is invalid: "extensions" is not supported.

Setting 'extensions' option in plugin while using flat config (configType: 'flat').

fix

Remove 'extensions' from plugin options and configure file extensions via ESLint's 'files' option in flat config.

Upgrade

Version history

4.4.1latest on npm

Audit

Dependencies

eslintrequiredPeer dependency; the plugin uses ESLint's Node.js API.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/rstackjs/eslint-rspack-plugin ↗

packagehttps://www.npmjs.com/package/eslint-rspack-plugin ↗