![Introducing Dashboard Analytics](https://cdn.sanity.io/images/cgdhsj6q/production/af327c5bd94708db501516a75da6870aef894c64-2286x1522.png?w=400&fit=max&auto=format)
Product
Introducing Dashboard Analytics
We're introducing a new Analytics feature in the Socket dashboard so you can view changes in your organization's and repositories' alerts over time.
@typescript-eslint/parser
Advanced tools
The @typescript-eslint/parser is an ESLint parser that allows for the analysis and linting of TypeScript code. It is part of the TypeScript-ESLint project, which aims to bring ESLint's powerful static analysis capabilities to TypeScript codebases. The parser converts TypeScript source code into an ESTree-compatible form so that it can be used by ESLint for linting and other code analysis tasks.
Parsing TypeScript code
This feature allows the parser to read TypeScript files and produce an abstract syntax tree (AST) that is compatible with ESLint, enabling it to understand and lint TypeScript syntax.
const { ESLint } = require('eslint');
async function main() {
const eslint = new ESLint({
parser: '@typescript-eslint/parser',
parserOptions: {
ecmaVersion: 2020,
sourceType: 'module',
project: './tsconfig.json'
}
});
const results = await eslint.lintFiles(['src/**/*.ts']);
// Handle the results
}
main();
Integration with ESLint rules
The parser can be used in conjunction with ESLint rules, including those specifically designed for TypeScript, to enforce code quality and style guidelines.
module.exports = {
parser: '@typescript-eslint/parser',
extends: [
'plugin:@typescript-eslint/recommended'
],
rules: {
'@typescript-eslint/no-unused-vars': 'error',
'@typescript-eslint/explicit-function-return-type': 'warn'
}
};
babel-eslint is an ESLint parser that allows you to lint all valid Babel code with ESLint. While it is not specifically designed for TypeScript, it can be used to lint code that uses Babel for transpilation, including TypeScript when used with the appropriate Babel plugins.
This is a deprecated package that was used to provide ESLint rules for TypeScript before the TypeScript-ESLint project was created. It has been replaced by the @typescript-eslint/parser and typescript-eslint/eslint-plugin packages.
An ESLint parser which leverages TypeScript ESTree to allow for ESLint to lint TypeScript source code.
You can find our Getting Started docs here
These docs walk you through setting up ESLint, this parser, and our plugin. If you know what you're doing and just want to quick start, read on...
$ yarn add -D typescript @typescript-eslint/parser
$ npm i --save-dev typescript @typescript-eslint/parser
In your ESLint configuration file, set the parser
property:
{
"parser": "@typescript-eslint/parser"
}
There is sometimes an incorrect assumption that the parser itself is what does everything necessary to facilitate the use of ESLint with TypeScript. In actuality, it is the combination of the parser and one or more plugins which allow you to maximize your usage of ESLint with TypeScript.
For example, once this parser successfully produces an AST for the TypeScript source code, it might well contain some information which simply does not exist in a standard JavaScript context, such as the data for a TypeScript-specific construct, like an interface
.
The core rules built into ESLint, such as indent
have no knowledge of such constructs, so it is impossible to expect them to work out of the box with them.
Instead, you also need to make use of one more plugins which will add or extend rules with TypeScript-specific features.
By far the most common case will be installing the @typescript-eslint/eslint-plugin
plugin, but there are also other relevant options available such a @typescript-eslint/eslint-plugin-tslint
.
The following additional configuration options are available by specifying them in parserOptions
in your ESLint configuration file.
interface ParserOptions {
ecmaFeatures?: {
jsx?: boolean;
globalReturn?: boolean;
};
ecmaVersion?: number;
jsxPragma?: string;
jsxFragmentName?: string | null;
lib?: string[];
project?: string | string[];
projectFolderIgnoreList?: string[];
tsconfigRootDir?: string;
extraFileExtensions?: string[];
warnOnUnsupportedTypeScriptVersion?: boolean;
}
parserOptions.ecmaFeatures.jsx
Default false
.
Enable parsing JSX when true
. More details can be found here.
NOTE: this setting does not affect known file types (.js
, .jsx
, .ts
, .tsx
, .json
) because the TypeScript compiler has its own internal handling for known file extensions. The exact behavior is as follows:
parserOptions.project
is not provided:
.js
, .jsx
, .tsx
files are parsed as if this is true..ts
files are parsed as if this is false..md
, .vue
) will respect this setting.parserOptions.project
is provided (i.e. you are using rules with type information):
.js
, .jsx
, .tsx
files are parsed as if this is true..ts
files are parsed as if this is false..md
, .vue
) are parsed as if this is false.parserOptions.ecmaFeatures.globalReturn
Default false
.
This options allows you to tell the parser if you want to allow global return
statements in your codebase.
parserOptions.ecmaVersion
Default 2018
.
Accepts any valid ECMAScript version number:
The value must be a number - so do not include the es
prefix.
Specifies the version of ECMAScript syntax you want to use. This is used by the parser to determine how to perform scope analysis, and it affects the default
parserOptions.jsxPragma
Default 'React'
The identifier that's used for JSX Elements creation (after transpilation).
If you're using a library other than React (like preact
), then you should change this value.
This should not be a member expression - just the root identifier (i.e. use "React"
instead of "React.createElement"
).
If you provide parserOptions.project
, you do not need to set this, as it will automatically detected from the compiler.
parserOptions.jsxFragmentName
Default null
The identifier that's used for JSX fragment elements (after transpilation).
If null
, assumes transpilation will always use a member of the configured jsxPragma
.
This should not be a member expression - just the root identifier (i.e. use "h"
instead of "h.Fragment"
).
If you provide parserOptions.project
, you do not need to set this, as it will automatically detected from the compiler.
parserOptions.lib
Default ['es2018']
For valid options, see the TypeScript compiler options.
Specifies the TypeScript lib
s that are available. This is used by the scope analyser to ensure there are global variables declared for the types exposed by TypeScript.
If you provide parserOptions.project
, you do not need to set this, as it will automatically detected from the compiler.
parserOptions.project
Default undefined
.
This option allows you to provide a path to your project's tsconfig.json
. This setting is required if you want to use rules which require type information. Relative paths are interpreted relative to the current working directory if tsconfigRootDir
is not set. If you intend on running ESLint from directories other than the project root, you should consider using tsconfigRootDir
.
Accepted values:
// path
project: './tsconfig.json';
// glob pattern
project: './packages/**/tsconfig.json';
// array of paths and/or glob patterns
project: ['./packages/**/tsconfig.json', './separate-package/tsconfig.json'];
If you use project references, TypeScript will not automatically use project references to resolve files. This means that you will have to add each referenced tsconfig to the project
field either separately, or via a glob.
TypeScript will ignore files with duplicate filenames in the same folder (for example, src/file.ts
and src/file.js
). TypeScript purposely ignore all but one of the files, only keeping the one file with the highest priority extension (the extension priority order (from highest to lowest) is .ts
, .tsx
, .d.ts
, .js
, .jsx
). For more info see #955.
Note that if this setting is specified and createDefaultProgram
is not, you must only lint files that are included in the projects as defined by the provided tsconfig.json
files. If your existing configuration does not include all of the files you would like to lint, you can create a separate tsconfig.eslint.json
as follows:
{
// extend your base config so you don't have to redefine your compilerOptions
"extends": "./tsconfig.json",
"include": [
"src/**/*.ts",
"test/**/*.ts",
"typings/**/*.ts",
// etc
// if you have a mixed JS/TS codebase, don't forget to include your JS files
"src/**/*.js"
]
}
parserOptions.tsconfigRootDir
Default undefined
.
This option allows you to provide the root directory for relative tsconfig paths specified in the project
option above.
parserOptions.projectFolderIgnoreList
Default ["**/node_modules/**"]
.
This option allows you to ignore folders from being included in your provided list of project
s.
This is useful if you have configured glob patterns, but want to make sure you ignore certain folders.
It accepts an array of globs to exclude from the project
globs.
For example, by default it will ensure that a glob like ./**/tsconfig.json
will not match any tsconfig
s within your node_modules
folder (some npm packages do not exclude their source files from their published packages).
parserOptions.extraFileExtensions
Default undefined
.
This option allows you to provide one or more additional file extensions which should be considered in the TypeScript Program compilation.
The default extensions are .ts
, .tsx
, .js
, and .jsx
. Add extensions starting with .
, followed by the file extension. E.g. for a .vue
file use "extraFileExtensions: [".vue"]
.
parserOptions.warnOnUnsupportedTypeScriptVersion
Default true
.
This option allows you to toggle the warning that the parser will give you if you use a version of TypeScript which is not explicitly supported
parserOptions.createDefaultProgram
Default false
.
This option allows you to request that when the project
setting is specified, files will be allowed when not included in the projects defined by the provided tsconfig.json
files. Using this option will incur significant performance costs. This option is primarily included for backwards-compatibility. See the project
section above for more information.
Please see typescript-eslint
for the supported TypeScript version.
Please ensure that you are using a supported version before submitting any issues/bug reports.
Please use the @typescript-eslint/parser
issue template when creating your issue and fill out the information requested as best you can. This will really help us when looking into your issue.
TypeScript ESLint Parser is licensed under a permissive BSD 2-clause license.
FAQs
An ESLint custom parser which leverages TypeScript ESTree
The npm package @typescript-eslint/parser receives a total of 21,300,750 weekly downloads. As such, @typescript-eslint/parser popularity was classified as popular.
We found that @typescript-eslint/parser demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
We're introducing a new Analytics feature in the Socket dashboard so you can view changes in your organization's and repositories' alerts over time.
Security News
A new OpenSSF report uncovers critical gaps in secure software training, with 75% of new developers unfamiliar with secure practices, highlighting urgent educational needs.
Security News
The 2023 Python Developers Survey reveals key trends in packaging, web frameworks, and developer demographics, highlighting a shift toward innovative tools as the Python community diversifies and grows among less experienced developers.