Ccodemod

codemod/eslint-custom-rules-v8-to-v9

Migrate custom ESLint rules from v8 to v9 format

transformationmigrationeslintv8v9
Private
5 executions

Run locally

npx codemod @codemod/eslint-custom-rules-v8-to-v9

@codemod/eslint-custom-rules-v8-to-v9

Automatically migrate your custom ESLint rules from v8 to v9 format.

Overview

This codemod transforms your custom ESLint rules to be compatible with ESLint v9. It handles all breaking changes in the custom rule API, including context method removals, new rule structure requirements, and deprecated APIs.

What This Codemod Does

This codemod performs a comprehensive migration of custom ESLint rules from v8 to v9. It handles the following breaking changes from the official ESLint v9 migration guide:

  • Removed multiple context methods - migrates to sourceCode equivalents
  • Removed sourceCode.getComments() - converts to combination of getCommentsBefore/Inside/After
  • Removed CodePath#currentSegments - adds code path tracking logic
  • Function-style rules are no longer supported - converts to object format with meta and create

Detailed Transformations:

Custom Rule Migration

Transforms your custom ESLint rules to the new format:

  • Converts old function-based rule exports to the new object format with meta and create properties
  • Updates context method calls to use context.sourceCode (e.g., context.getSource()contextSourceCode.getText())
  • Migrates deprecated methods:
    • getSourcegetText
    • getSourceLinesgetLines
    • getComments → combination of getCommentsBefore/Inside/After
    • getAncestors, getScope, markVariableAsUsed with TODO comments for new parameters
  • Handles currentSegments API changes by adding necessary code path tracking
  • Detects fixable rules and adds fixable: "code" to meta

Usage

Migrate Custom Rules

Run the codemod and provide paths to your rule files or directories:

bash

You'll be prompted to provide paths to your rule files or directories:

bash

Manual Steps Required

After running this codemod, you need to:

  1. Review TODO comments in migrated custom rules for context method migrations:

    Removed on contextReplacement on SourceCode
    context.getAncestors()sourceCode.getAncestors(node)
    context.getScope()sourceCode.getScope(node)
    context.markVariableAsUsed(name)sourceCode.markVariableAsUsed(name, node)
  2. Test your custom rules:

bash

Resources

Official ESLint Documentation

Ready to evolve your codebase?

Build tailored, compiler-aware skills to assess, plan, and automate complex codebase changes.