@typescript-eslint/rule-tester

What is @typescript-eslint/rule-tester?

@typescript-eslint/rule-tester is a utility package designed to help developers test custom ESLint rules for TypeScript code. It provides a framework for writing unit tests for ESLint rules, ensuring that they behave as expected when applied to TypeScript code.

What are @typescript-eslint/rule-tester's main functionalities?

Testing ESLint Rules

This feature allows you to test custom ESLint rules by providing valid and invalid code samples. The RuleTester runs the rule against these samples and checks if the expected errors are reported.

const { RuleTester } = require('@typescript-eslint/rule-tester');
const rule = require('path/to/your/custom-rule');

const ruleTester = new RuleTester({
  parser: '@typescript-eslint/parser',
});

ruleTester.run('your-rule-name', rule, {
  valid: [
    {
      code: 'const x: number = 42;',
    },
  ],
  invalid: [
    {
      code: 'const x: string = 42;',
      errors: [{ messageId: 'expectedNumber' }],
    },
  ],
});

0

README

@typescript-eslint/rule-tester

Tooling to test ESLint rules

👉 See https://typescript-eslint.io/packages/rule-tester for documentation on this package.

Changelog

8.14.0 (2024-11-11)

🚀 Features

• eslint-plugin: [no-confusing-void-expression] add an option to ignore void<->void (#10067)
• eslint-plugin: [await-thenable] report unnecessary await using statements (#10209)

🩹 Fixes

• deps: update dependency eslint to v9.14.0 (#10309)
• deps: update docusaurus monorepo to v3.6.0 (#10319)
• eslint-plugin: [no-unnecessary-condition] improve error message for literal comparisons (#10194)
• eslint-plugin: [no-misused-promises] improve report loc for methods (#10216)
• scope-manager: fix asserted increments not being marked as write references (#10271)

❤️ Thank You

• Gyumong @Gyumong
• Jan Ochwat @janek515
• Kirk Waiblinger @kirkwaiblinger
• Ronen Amiel

You can read about our versioning strategy and releases on our website.