@typescript-eslint/visitor-keys

What is @typescript-eslint/visitor-keys?

The @typescript-eslint/visitor-keys package provides an enumeration of TypeScript ESTree AST node types and their respective visitor keys. It is primarily used in the context of ESLint plugins and custom rules development to traverse the AST (Abstract Syntax Tree) of TypeScript code and analyze or manipulate the code structure.

What are @typescript-eslint/visitor-keys's main functionalities?

AST Node Traversal

This code demonstrates how to use the visitor keys from the package to traverse an AST node and its children recursively. The `traverseAST` function takes a node and a visitor object that contains methods corresponding to node types. It uses the visitor keys to determine which properties of a node to traverse.

const visitorKeys = require('@typescript-eslint/visitor-keys');

function traverseAST(node, visitor) {
  if (visitor[node.type]) {
    visitor[node.type](node);
  }

  const keys = visitorKeys[node.type] || [];
  keys.forEach((key) => {
    const value = node[key];
    if (Array.isArray(value)) {
      value.forEach(child => traverseAST(child, visitor));
    } else if (value && typeof value === 'object') {
      traverseAST(value, visitor);
    }
  });
}

Other packages similar to @typescript-eslint/visitor-keys

eslint-visitor-keys

This package provides a list of visitor keys for traversing the AST of JavaScript code. It is similar to @typescript-eslint/visitor-keys but is tailored for JavaScript rather than TypeScript. It is used by ESLint to work with its own rules and plugins.

babel-types

While not a direct equivalent, babel-types is part of the Babel ecosystem and provides definitions for various AST node types, builders, and assertion methods. It can be used to traverse and manipulate ASTs for both JavaScript and TypeScript, offering a broader scope compared to @typescript-eslint/visitor-keys.

estraverse

Estraverse is a simple and flexible library for traversing and replacing nodes in an ECMAScript AST. It is not TypeScript-specific but can be used with JavaScript ASTs. It provides a similar traversal functionality but does not rely on a predefined set of visitor keys.

README

@typescript-eslint/visitor-keys

Visitor keys used to help traverse the TypeScript-ESTree AST.

✋ Internal Package

This is an internal package to the typescript-eslint monorepo. You likely don't want to use it directly.

👉 See https://typescript-eslint.io for docs on typescript-eslint.

Changelog

8.12.0 (2024-10-28)

🚀 Features

• eslint-plugin: [prefer-nullish-coalescing] add support for assignment expressions (#10152)
• eslint-plugin: [consistent-indexed-object-style] report mapped types (#10160)
• eslint-plugin: [switch-exhaustiveness-check] add allowDefaultCaseMatchUnionMember option (#9954)
• eslint-plugin: [no-base-to-string] handle String() (#10005)
• typescript-eslint: improve undefined extension handling (#10177)

🩹 Fixes

• eslint-plugin: [no-unsafe-return] don't reiterate through all type parts for each part (#10203)
• website: enable noImplicitAny (#10175)

❤️ Thank You

• Abraham Guo
• Kim Sang Du @developer-bandi
• Kirk Waiblinger @kirkwaiblinger
• Maxim Stykow @mstykow
• Terry Fu
• YeonJuan @yeonjuan

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