●Change8

Migrating to ESLint v10.0.0-alpha.0

Version v10.0.0-alpha.0 introduces 10 breaking changes. This guide details how to update your code.

Released: 11/14/2025

10
Breaking Changes
5
Migration Steps
10
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

RuleContextRuleFixerScopeManager.addGlobalsno-invalid-regexpradixfunc-namesno-shadow-restricted-namesLintMessage.nodeTypeTestCaseError.typeeslint:recommended

Breaking Changes

●Issue #1

Removed deprecated rule context methods. Rules using these methods must be updated to use the new context API.

●Issue #2

Removed support for .eslintrc configuration files. Users must migrate to the flat config format (eslint.config.js).

●Issue #3

Program range now spans the entire source text, which may affect plugins relying on specific AST offsets.

●Issue #4

RuleFixer methods now strictly assert that 'text' is a string.

●Issue #5

The 'always' and 'as-needed' options for the 'radix' rule are now deprecated/removed.

●Issue #6

eslint-env comments are now reported as errors; environment configuration should be moved to the config file.

●Issue #7

Removed deprecated LintMessage#nodeType and TestCaseError#type properties.

●Issue #8

Dropped support for jiti versions older than 2.2.0.

●Issue #9

no-shadow-restricted-names now reports 'globalThis' by default.

●Issue #10

Minimum Node.js version requirement increased to ^20.19.0 || ^22.13.0 || >=24.

Migration Steps

  1. 1
    Upgrade Node.js to a supported version (^20.19.0, ^22.13.0, or >=24).
  2. 2
    Convert .eslintrc configuration files to the flat config (eslint.config.js) format.
  3. 3
    Remove eslint-env comments from source files and move environment globals to the configuration file.
  4. 4
    Update custom rules to avoid deprecated context methods and nodeType properties.
  5. 5
    Ensure jiti is updated to version 2.2.0 or higher if used.

Release Summary

ESLint v10 introduces significant breaking changes including the removal of .eslintrc support, updated Node.js requirements, and the removal of deprecated rule context methods. It also updates the recommended configuration and tightens several rule schemas.

Need More Details?

View the full release notes and all changes for ESLint v10.0.0-alpha.0.

View Full Changelog