7.0.1

Disallowed passing inline useEffectEvent values as JSX props to guard against accidental propagation. (#34820 by @jf-eirinha)
Switch to export = so eslint-plugin-react-hooks emits correct types for consumers in Node16 ESM projects. (#34949 by @karlhorky)
Tightened the typing of configs.flat so the configs export is always defined. (#34950 by @poteto)
Fix named import runtime errors. (#34951, #34953 by @karlhorky)

7.0.0

This release slims down presets to just 2 configurations (recommended and recommended-latest), and all compiler rules are enabled by default.

Breaking: Removed recommended-latest-legacy and flat/recommended configs. The plugin now provides recommended (legacy and flat configs with all recommended rules), and recommended-latest (legacy and flat configs with all recommended rules plus new bleeding edge experimental compiler rules). (@poteto in #34757)

6.1.1

Note: 6.1.0 accidentally allowed use of recommended without flat config, causing errors when used with ESLint v9's defineConfig() helper. This has been fixed in 6.1.1.

Fix recommended config for flat config compatibility. The recommended config has been converted to flat config format. Non-flat config users should use recommended-legacy instead. (@poteto in #34700)
Add recommended-latest and recommended-latest-legacy configs that include React Compiler rules. (@poteto in #34675)
Remove unused NoUnusedOptOutDirectives rule. (@poteto in #34703)
Remove hermes-parser and dependency. (@poteto in #34719)
Remove @babel/plugin-proposal-private-methods dependency. (@ArnaudBarre and @josephsavona in #34715)
Update for Zod v3/v4 compatibility. (@kolian and @josephsavona in #34717)

6.1.0

Note: Version 6.0.0 was mistakenly released and immediately deprecated and untagged on npm. This is the first official 6.x major release and includes breaking changes.

Breaking: Require Node.js 18 or newer. (@michaelfaith in #32458)
Breaking: Flat config is now the default recommended preset. Legacy config moved to recommended-legacy. (@michaelfaith in #32457)
New Violations: Disallow calling use within try/catch blocks. (@poteto in #34040)
New Violations: Disallow calling useEffectEvent functions in arbitrary closures. (@jbrown215 in #33544)
Handle React.useEffect in addition to useEffect in rules-of-hooks. (@Ayc0 in #34076)
Added react-hooks settings config option that to accept additionalEffectHooks that are used across exhaustive-deps and rules-of-hooks rules. (@jbrown215) in #34497

6.0.0

Accidentally released. See 6.1.0 for the actual changes.

5.2.0

Support flat config (@michaelfaith in #30774)
Convert the plugin to TypeScript and provide package type declarations (@michaelfaith in #32279, #32283, #32240, #32400 and @poteto in #32420)
Fix false positive error in components with do/while loops (@tyxla in #31720)
Detect issues in class properties (@mjesun & @ecraig12345 in #31823)

5.1.0

Add support for do/while loops (@tyxla in #28714)
Fix error when callback argument is an identifier with an as expression (@mskelton in #31119)

5.0.0

New Violations: Component names now need to start with an uppercase letter instead of a non-lowercase letter. This means _Button or _component are no longer valid. (@kassens) in #25162

Consider dispatch from useActionState stable. (@eps1lon in #29665)
Add support for ESLint v9. (@eps1lon in #28773)
Accept as expression in callback. (@StyleShit in #28202)
Accept as expressions in deps array. (@StyleShit in #28189)
Treat React.use() the same as use(). (@kassens in #27769)
Move use() lint to non-experimental. (@kassens in #27768)
Support Flow as expressions. (@cpojer in #27590)
Allow useEffect(fn, undefined). (@kassens in #27525)
Disallow hooks in async functions. (@acdlite in #27045)
Rename experimental useEvent to useEffectEvent. (@sebmarkbage in #25881)
Lint for presence of useEvent functions in dependency lists. (@poteto in #25512)
Check useEvent references instead. (@poteto in #25319)
Update RulesOfHooks with useEvent rules. (@poteto in #25285)

4.6.0

4.5.0

Fix false positive error with large number of branches. (@scyron6 in #24287)

4.4.0

No changes, this was an automated release together with React 18.

4.3.0

Support ESLint 8. (@MichaelDeBoey in #22248)
Fix a crash with an empty effect. (@ChrisRu in #20385)
Improve the error message. (@callmetwan in #20692)
Handle optional chained methods as dependency. (@AriPerkkio in #20247)
Assume the new useTransition signature in the rule. (@rickhanlonii in #20976)

4.2.0

No changes, this was an automated release together with React 17.

4.1.2

Fix a crash with the TypeScript 4.x parser. (@eps1lon in #19815)

4.1.1

Improve support for optional chaining. (@pfongkye in #19680)
Fix a false positive warning for TypeScript parameters. (@NeoRaider in #19751)

4.1.0

New Violations: Warn when dependencies change on every render. (@captbaritone in #19590)

4.0.8

Fixes TypeScript typeof annotation to not be considered a dependency. (@delca85 in #19316)

4.0.7

Fixes an overly coarse dependency suggestion. (@gaearon in #19313)

4.0.6

Fix crashes and other bugs related to optional chaining. (@gaearon in #19273 and #19275)

4.0.5

Fix a crash when the dependency array has an empty element. (@yeonjuan in #19145)
Fix a false positive warning that occurs with optional chaining. (@fredvollmer in #19061)

4.0.4

Fix a false positive warning that occurs with optional chaining. (@fredvollmer in #19061)
Support nullish coalescing and optional chaining. (@yanneves in #19008)

4.0.3

Remove the heuristic that checks all Hooks ending with Effect due to too many false positives. (@gaearon in #19004)

4.0.2

Prevent Hooks that have Effect in the middle from being considered effects. (@surgeboris in #18907)

4.0.1

Declare support for ESLint 7. (@MichaelDeBoey in #18878)

4.0.0

New Violations: Consider PascalCase.useFoo() calls as Hooks. (@cyan33 in #18722)
New Violations: Check callback body when it's not written inline. (@gaearon in #18435)
New Violations: Check dependencies for all Hooks ending with Effect. (@airjp73 in #18580)
Add a way to enable the dangerous autofix. (@gaearon in #18437)
Offer a more sensible suggestion when encountering an assignment. (@Zzzen in #16784)
Consider TypeScript casts of useRef as constant. (@sophiebits in #18496)
Add documentation. (@ghmcadams in #16607)

3.0.0

New Violations: Forbid calling Hooks from classes. (@ianobermiller in #18341)
Add a recommended config. (@SimenB in #14762)

2.5.0

Fix a misleading error message in loops. (@M-Izadmehr in #16853)

2.4.0

New Violations: Run checks for functions passed to forwardRef. (@dprgarner in #17255)
New Violations: Check for ref usage in any Hook containing the word Effect. (@gaearon in #17663)
Disable dangerous autofix and use ESLint Suggestions API instead. (@wdoug in #17385)

2.0.0

New Violations: Forbid calling Hooks at the top level. (@gaearon in #16455)
Fix a crash when referencing arguments in arrow functions. (@hristo-kanchev in #16356)

1.x

The 1.x releases aren’t noted in this changelog, but you can find them in the commit history.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!