An ESLint custom parser which leverages TypeScript ESTree

TypeScript ESLint Parser

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

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-eslint/parser


In your ESLint configuration file, set the parserproperty:

  "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 andone 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 indenthave 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-pluginplugin, 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 parserOptionsin your ESLint configuration file.

interface ParserOptions {
  ecmaFeatures?: {
    jsx?: boolean;
  project?: string | string[];
  tsconfigRootDir?: string;
  extraFileExtensions?: string[];
  warnOnUnsupportedTypeScriptVersion?: boolean;


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:

  • if parserOptions.projectis notprovided:
    • .js, .jsx, .tsxfiles are parsed as if this is true.
    • .tsfiles are parsed as if this is false.
    • unknown extensions (.md, .vue) will respect this setting.
  • if parserOptions.projectis provided (i.e. you are using rules with type information):
    • .js, .jsx, .tsxfiles are parsed as if this is true.
    • .tsfiles are parsed as if this is false.
    • "unknown" extensions (.md, .vue) are parsed as if this is false.


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 tsconfigRootDiris 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 projectfield either separately, or via a glob.

  • TypeScript will ignore files with duplicate filenames in the same folder (for example, src/file.tsand 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 createDefaultProgramis not, you must only lint files that are included in the projects as defined by the provided tsconfig.jsonfiles. If your existing configuration does not include all of the files you would like to lint, you can create a separate tsconfig.eslint.jsonas follows:

      // extend your base config so you don't have to redefine your compilerOptions
      "extends": "./tsconfig.json",
      "include": [
        // etc
        // if you have a mixed JS/TS codebase, don't forget to include your JS files


Default undefined.

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


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 .vuefile 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 projectsetting is specified, files will be allowed when not included in the projects defined by the provided tsconfig.jsonfiles. Using this option will incur significant performance costs. This option is primarily included for backwards-compatibility.See the projectsection above for more information.

Supported TypeScript Version

Please see typescript-eslintfor 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/parserissue 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






扫码加入 JavaScript 社区