ESLint Scope

ESLint Scope is the ECMAScript scope analyzer used in ESLint. It is a fork of escope.

Install

npm i eslint-scope --save

📖 Usage

To use in an ESM file:

1import * as eslintScope from 'eslint-scope';

To use in a CommonJS file:

1const eslintScope = require('eslint-scope');

In order to analyze scope, you'll need to have an ESTree compliant AST structure to run it on. The primary method is eslintScope.analyze(), which takes two arguments:

1. ast - the ESTree-compliant AST structure to analyze.
2. options (optional) - Options to adjust how the scope is analyzed, including:

• ignoreEval (default: false) - Set to true to ignore all eval() calls (which would normally create scopes).
• nodejsScope (default: false) - Set to true to create a top-level function scope needed for CommonJS evaluation.
• impliedStrict (default: false) - Set to true to evaluate the code in strict mode even outside of modules and without "use strict".
• ecmaVersion (default: 5) - The version of ECMAScript to use to evaluate the code.
• sourceType (default: "script") - The type of JavaScript file to evaluate. Change to "module" for ECMAScript module code.
• childVisitorKeys (default: null) - An object with visitor key information (like eslint-visitor-keys). Without this, eslint-scope finds child nodes to visit algorithmically. Providing this option is a performance enhancement.
• fallback (default: "iteration") - The strategy to use when childVisitorKeys is not specified. May be a function.
• jsx (default: false) - Enables the tracking of JSX components as variable references.

Example:

1import * as eslintScope from 'eslint-scope';
2import * as espree from 'espree';
3import estraverse from 'estraverse';
4
5const options = {
6    ecmaVersion: 2022,
7    sourceType: "module"
8};
9
10const ast = espree.parse(code, { range: true, ...options });
11const scopeManager = eslintScope.analyze(ast, options);
12
13const currentScope = scopeManager.acquire(ast);   // global scope
14
15estraverse.traverse(ast, {
16    enter (node, parent) {
17        // do stuff
18
19        if (/Function/.test(node.type)) {
20            currentScope = scopeManager.acquire(node);  // get current function scope
21        }
22    },
23    leave(node, parent) {
24        if (/Function/.test(node.type)) {
25            currentScope = currentScope.upper;  // set to parent scope
26        }
27
28        // do stuff
29    }
30});

Contributing

Issues and pull requests will be triaged and responded to as quickly as possible. We operate under the ESLint Contributor Guidelines, so please be sure to read them before contributing. If you're not sure where to dig in, check out the issues.

Security Policy

We work hard to ensure that ESLint Scope is safe for everyone and that security issues are addressed quickly and responsibly. Read the full security policy.

Build Commands

• npm test - run all linting and tests
• npm run lint - run all linting

License

ESLint Scope is licensed under a permissive BSD 2-clause license.

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.