eslint-type-tracer

Introduction

eslint-type-tracer is the type tracer for ESLint rules.

📛 Features

Trace and infer types of expression nodes for ESLint rules.

💿 Installation

npm install eslint-type-tracer

Requirements

• ESLint v8.57.0 and above
• Node.js v14.18.0, v16.0.0 and above

📖 Usage

API

buildTypeChecker

import { buildTypeChecker, type TypeName } from "eslint-type-tracer";

Builds a type checker function for use in ESLint rules. This function helps you determine if a given AST node is of a specific type.

Signature:

function buildTypeChecker(
  sourceCode: SourceCode,
  options?: { aggressiveResult?: false | "aggressive" }
): (
  node: TSESTree.Expression,
  className: TypeName,
  memberAccessNode?: TSESTree.MemberExpression | TSESTree.Property
) => boolean | "aggressive";

• sourceCode: The ESLint SourceCode object.
• options.aggressiveResult: If set to "aggressive", returns this value when the type cannot be determined. Default is false.

Returns:

A function that takes an expression node, a type name, and optionally a member access node, and returns true if the node is of the specified type, false if not, or "aggressive" if undetermined and the option is set.

Example:

const typeChecker = buildTypeChecker(context.sourceCode);
if (typeChecker(node, "Array")) {
  // node is an Array
}

🍻 Contributing

Welcome contributing!

Please use GitHub's Issues/PRs.

Development Tools

• npm run test runs tests.

🔒 License

See the LICENSE file for license rights and limitations (MIT).

Changelog

0.1.0

Minor Changes

• f9f4fa5 Thanks @ota-meshi! - First Release