Registry / testing / eslint-plugin-react-debug

eslint-plugin-react-debug

library4.2.3jsnpmunverified

An ESLint plugin that provides debugging-related rules for React, part of the eslint-react monorepo. Current stable version is 4.2.3, but the latest releases are beta versions (5.5.1-beta.0 as of April 2026). It requires ESLint ^10.0.0 and TypeScript, and Node.js >=22.0.0. The plugin ships TypeScript types and is designed to help debug React components, focusing on rules that catch common mistakes and anti-patterns during development. It differentiates from other React ESLint plugins by being specifically tailored for debugging scenarios within the eslint-react ecosystem.

testing

npm install eslint-plugin-react-debug

github ↗package ↗

INSTALL

IMPORT

SIG · ESLINT-PLUGIN-REAC

eslint-plugin-react-debug

testingjavascriptv4.2.3

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.

default

✓ import plugin from 'eslint-plugin-react-debug'

✗ const plugin = require('eslint-plugin-react-debug')

ESM-only; CJS require() fails in Node >=22 with default package type.

rules

✓ import { rules } from 'eslint-plugin-react-debug'

Named export for rule definitions.

configs

✓ import { configs } from 'eslint-plugin-react-debug'

✗ import configs from 'eslint-plugin-react-debug/configs'

Configurations are exported as named export, not a separate module.

Configures ESLint with eslint-plugin-react-debug and eslint-plugin-react-x, enabling debugging and React X rules for TypeScript/TSX files.

import debugPlugin from 'eslint-plugin-react-debug'; import reactPlugin from 'eslint-plugin-react-x'; import tsParser from '@typescript-eslint/parser'; export default [ { files: ['**/*.{ts,tsx}'], languageOptions: { parser: tsParser, parserOptions: { ecmaFeatures: { jsx: true }, }, }, plugins: { 'react-debug': debugPlugin, 'react-x': reactPlugin, }, rules: { 'react-debug/rule-name': 'warn', 'react-x/no-set-state': 'error', }, }, ];

Debug

Known issues

breakingRequires Node.js >=22.0.0

fix

Update Node.js to version 22 or higher.

affects: >=4.2.3

breakingRequires ESLint ^10.0.0

fix

Update ESLint to version 10.0.0 or higher.

affects: >=4.2.3

gotchaPlugin uses ESM only; CommonJS require() will fail.

fix

Use import statement instead of require().

affects: >=4.2.3

deprecatedThe v5 beta series introduces breaking changes; stable v4 may be deprecated after v5 release.

fix

Migrate to v5 beta once stable or stay on v4.

affects: <5.0.0

Errors

Common errors & fixes

Cannot find module 'eslint-plugin-react-debug'

Missing dependency in package.json or incorrect import path.

fix

Run 'npm install eslint-plugin-react-debug --save-dev' or verify import path.

Error: ESLint configuration in 'your-file' is invalid: "plugins" field must be an array or an object

Using old ESLint flat config format incorrectly for plugins.

fix

Ensure plugins are provided as an object with plugin names as keys, e.g., 'plugins: { "react-debug": debugPlugin }'.

TypeError: Cannot read properties of undefined (reading 'someRule')

Rule name does not exist in the plugin.

fix

Check the available rules list in the plugin's documentation or refer to configurations.

Upgrade

Version history

4.2.3latest on npm

Audit

Dependencies

eslintrequiredPeer dependency required to run as an ESLint plugin

typescriptoptionalRequired for type checking and rule analysis

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/Rel1cx/eslint-react ↗

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