Big update!Introducing GitHub Bot Commands. Learn more
Log inBook a demo


Package Overview
File Explorer

Advanced tools


An ESLint custom parser which leverages TypeScript ESTree


Version published
Weekly downloads
increased by0.12%

Weekly downloads



5.45.0 (2022-11-28)

Bug Fixes

  • eslint-plugin: [array-type] --fix flag removes parentheses from type (#5997) (42b33af)
  • eslint-plugin: [keyword-spacing] prevent crash on no options (#6073) (1f19998)
  • eslint-plugin: [member-ordering] support private fields (#5859) (f02761a)
  • eslint-plugin: [prefer-readonly] report if a member's property is reassigned (#6043) (6e079eb)
  • scope-manager: add support for TS4.9 satisfies expression (#6059) (44027db)
  • typescript-estree: stub out ts.SatisfiesExpression on old TS versions (#6076) (1302b30)


  • eslint-plugin: [member-ordering] add a required option for required vs. optional member ordering (#5965) (2abadc6)
  • support Auto Accessor syntax (#5926) (becd1f8)



TypeScript ESLint Parser

An ESLint parser which leverages TypeScript ESTree to allow for ESLint to lint TypeScript source code.

CI NPM Version NPM Downloads

Getting Started

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 | 'latest'; jsxPragma?: string | null; jsxFragmentName?: string | null; lib?: string[]; project?: string | string[]; projectFolderIgnoreList?: string[]; tsconfigRootDir?: string; extraFileExtensions?: string[]; warnOnUnsupportedTypeScriptVersion?: boolean; program?: import('typescript').Program; moduleResolver?: string; emitDecoratorMetadata?: boolean; }


Default false.

Enable parsing JSX when true. More details can be found here.

NOTE: this setting does not affect known file types (.js, .mjs, .cjs, .jsx, .ts, .mts, .cts, .tsx, .json) because the TypeScript compiler has its own internal handling for known file extensions.

The exact behavior is as follows:

  • .js, .mjs, .cjs, .jsx, .tsx files are always parsed as if this is true.
  • .ts, .mts, .cts files are always parsed as if this is false.
  • For "unknown" extensions (.md, .vue):
    • If parserOptions.project is not provided:
      • The setting will be respected.
    • If parserOptions.project is provided (i.e. you are using rules with type information):
      • always parsed as if this is false


Default false.

This options allows you to tell the parser if you want to allow global return statements in your codebase.


Default 2018.

Accepts any valid ECMAScript version number or 'latest':

  • A version: es3, es5, es6, es7, es8, es9, es10, es11, es12, es13, ..., or
  • A year: es2015, es2016, es2017, es2018, es2019, es2020, es2021, es2022, ..., or
  • 'latest'

When it's a version or a year, 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


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. If you are using the new JSX transform you can set this to null.

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.


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.


Default ['es2018']

For valid options, see the TypeScript compiler options.

Specifies the TypeScript libs 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.


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.

  • Note that using wide globs ** in your parserOptions.project may cause performance implications. Instead of globs that use ** to recursively check all folders, prefer paths that use a single * at a time. For more info see #2611.

  • 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" ] }


Default undefined.

This option allows you to provide the root directory for relative tsconfig paths specified in the project option above.


Default ["**/node_modules/**"].

This option allows you to ignore folders from being included in your provided list of projects. 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 tsconfigs within your node_modules folder (some npm packages do not exclude their source files from their published packages).


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 ['.js', '.mjs', '.cjs', '.jsx', '.ts', '.mts', '.cts', '.tsx']. Add extensions starting with ., followed by the file extension. E.g. for a .vue file use "extraFileExtensions": [".vue"].


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


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.


Default undefined.

This option allows you to programmatically provide an array of one or more instances of a TypeScript Program object that will provide type information to rules. This will override any programs that would have been computed from parserOptions.project or parserOptions.createDefaultProgram. All linted files must be part of the provided program(s).


Default undefined.

This option allows you to provide a custom module resolution. The value should point to a JS file that default exports (export default, or module.exports =, or export =) a file with the following interface:

interface ModuleResolver { version: 1; resolveModuleNames( moduleNames: string[], containingFile: string, reusedNames: string[] | undefined, redirectedReference: ts.ResolvedProjectReference | undefined, options: ts.CompilerOptions, ): (ts.ResolvedModule | undefined)[]; }

Refer to the TypeScript Wiki for an example on how to write the resolveModuleNames function.

Note that if you pass custom programs via options.programs this option will not have any effect over them (you can simply add the custom resolution on them directly).


Default undefined.

This option allow you to tell parser to act as if emitDecoratorMetadata: true is set in tsconfig.json, but without type-aware linting. In other words, you don't have to specify parserOptions.project in this case, making the linting process faster.


createProgram(configFile, projectDirectory)

This serves as a utility method for users of the parserOptions.programs feature to create a TypeScript program instance from a config file.

declare function createProgram( configFile: string, projectDirectory?: string, ): import('typescript').Program;

Example usage in .eslintrc.js:

const parser = require('@typescript-eslint/parser'); const programs = [parser.createProgram('tsconfig.json')]; module.exports = { parserOptions: { programs, }, };

Supported TypeScript Version

Please see typescript-eslint for the supported TypeScript version.

Please ensure that you are using a supported version before submitting any issues/bug reports.

Reporting Issues

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.


See the contributing guide here



What is @typescript-eslint/parser?

An ESLint custom parser which leverages TypeScript ESTree

Is @typescript-eslint/parser popular?

The npm package @typescript-eslint/parser receives a total of 18,054,655 weekly downloads. As such, @typescript-eslint/parser popularity was classified as popular.

Is @typescript-eslint/parser well maintained?

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 1 open source maintainer collaborating on the project.

Last updated on 28 Nov 2022

Did you know?

Socket installs a Github app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install Socket


Subscribe to our newsletter

Get open source security insights delivered straight into your inbox. Be the first to learn about new features and product updates.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc