eslint-visitor-keys

eslint-visitor-keys

Constants and utilities about visitor keys to traverse AST.

💿 Installation

Use npm to install.

$ npm install eslint-visitor-keys

Requirements

• Node.js ^20.19.0, ^22.13.0, or >=24

📖 Usage

To use in an ESM file:

import * as evk from "eslint-visitor-keys"

To use in a CommonJS file:

const evk = require("eslint-visitor-keys")

evk.KEYS

type: { [type: string]: string[] | undefined }

Visitor keys. This keys are frozen.

This is an object. Keys are the type of ESTree nodes. Their values are an array of property names which have child nodes.

For example:

console.log(evk.KEYS.AssignmentExpression) // → ["left", "right"]

evk.getKeys(node)

type: (node: object) => string[]

Get the visitor keys of a given AST node.

This is similar to Object.keys(node) of ES Standard, but some keys are excluded: parent, leadingComments, trailingComments, and names which start with _.

This will be used to traverse unknown nodes.

For example:

const node = {
    type: "AssignmentExpression",
    left: { type: "Identifier", name: "foo" },
    right: { type: "Literal", value: 0 }
}
console.log(evk.getKeys(node)) // → ["type", "left", "right"]

evk.unionWith(additionalKeys)

type: (additionalKeys: object) => { [type: string]: string[] | undefined }

Make the union set with evk.KEYS and the given keys.

• The order of keys is, additionalKeys is at first, then evk.KEYS is concatenated after that.
• It removes duplicated keys as keeping the first one.

For example:

console.log(evk.unionWith({
    MethodDefinition: ["decorators"]
})) // → { ..., MethodDefinition: ["decorators", "key", "value"], ... }

📰 Change log

See GitHub releases.

🍻 Contributing

Welcome. See ESLint contribution guidelines.

Development commands

• npm test runs tests and measures code coverage.
• npm run lint checks source codes with ESLint.
• npm run test:open-coverage opens the code coverage report of the previous test with your default browser.

Sponsors

The following companies, organizations, and individuals support ESLint's ongoing maintenance and development. Become a Sponsor to get your logo on our READMEs and website.

Platinum Sponsors

Gold Sponsors

Silver Sponsors

Bronze Sponsors

Technology Sponsors

Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.

Similar packages

Other packages similar to eslint-visitor-keys

estraverse

Estraverse is a package for traversing JavaScript ASTs. It provides similar functionality to eslint-visitor-keys by allowing the traversal of AST nodes. However, estraverse focuses more on the traversal mechanism itself, including entering and leaving nodes, whereas eslint-visitor-keys primarily provides a list of keys for traversal.

acorn-walk

Acorn-walk is a syntax tree walker for the acorn AST format. Similar to eslint-visitor-keys, it aids in the navigation and analysis of ASTs. The key difference is that acorn-walk is tied to the acorn parser's AST format and provides walker functions for different node types, while eslint-visitor-keys offers a more generalized set of keys for any tool that works with JavaScript ASTs.