@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.7.0 (2024-09-23)

🚀 Features

• eslint-plugin: [no-unsafe-call] check calls of Function (#10010)
• eslint-plugin: [consistent-type-exports] check export * exports to see if all exported members are types (#10006)

🩹 Fixes

• eslint-plugin: properly coerce all types to string in getStaticMemberAccessValue (#10004)
• eslint-plugin: [no-deprecated] report on imported deprecated variables (#9987)
• eslint-plugin: [no-confusing-non-null-assertion] check !in and !instanceof (#9994)
• types: add NewExpression as a parent of SpreadElement (#10024)
• utils: add missing entries to the RuleListener selectors list (#9992)

❤️ Thank You

• Abraham Guo
• auvred @auvred
• Brian Donovan @eventualbuddha
• Kirk Waiblinger @kirkwaiblinger

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