You can find our Getting Started docs here You can find our FAQ / Troubleshooting docs here
These docs walk you through setting up ESLint, this plugin, and our parser. If you know what you're doing and just want to quick start, read on...
Make sure you have TypeScript and @typescript-eslint/parser
installed, then install the plugin:
yarn add -D @typescript-eslint/eslint-plugin
It is important that you use the same version number for @typescript-eslint/parser
and @typescript-eslint/eslint-plugin
.
Note: If you installed ESLint globally (using the -g
flag) then you must also install @typescript-eslint/eslint-plugin
globally.
Add @typescript-eslint/parser
to the parser
field and @typescript-eslint
to the plugins section of your .eslintrc
configuration file, then configure the rules you want to use under the rules section.
{
"parser": "@typescript-eslint/parser",
"plugins": ["@typescript-eslint"],
"rules": {
"@typescript-eslint/rule-name": "error"
}
}
You can also enable all the recommended rules for our plugin. Add plugin:@typescript-eslint/recommended
in extends:
{
"extends": ["plugin:@typescript-eslint/recommended"]
}
Note: Make sure to use eslint --ext .js,.ts
since by default eslint
will only search for .js
files.
You can also use eslint:recommended
(the set of rules which are recommended for all projects by the ESLint Team) with this plugin. As noted in the root README, not all ESLint core rules are compatible with TypeScript, so you need to add both eslint:recommended
and plugin:@typescript-eslint/eslint-recommended
(which will adjust the one from ESLint appropriately for TypeScript) to your config:
{
"extends": [
"eslint:recommended",
"plugin:@typescript-eslint/eslint-recommended",
"plugin:@typescript-eslint/recommended"
]
}
As of version 2 of this plugin, by design, none of the rules in the main recommended
config require type-checking in order to run. This means that they are more lightweight and faster to run.
Some highly valuable rules simply require type-checking in order to be implemented correctly, however, so we provide an additional config you can extend from called recommended-requiring-type-checking
. You would apply this in addition to the recommended configs previously mentioned, e.g.:
{
"extends": [
"eslint:recommended",
"plugin:@typescript-eslint/eslint-recommended",
"plugin:@typescript-eslint/recommended",
"plugin:@typescript-eslint/recommended-requiring-type-checking"
]
}
Pro Tip: For larger codebases you may want to consider splitting our linting into two separate stages: 1. fast feedback rules which operate purely based on syntax (no type-checking), 2. rules which are based on semantics (type-checking).
You can read more about linting with type information here
Key: ✔️ = recommended, 🔧 = fixable, 💭 = requires type information
Name | Description | ✔️ | 🔧 | 💭 |
---|---|---|---|---|
@typescript-eslint/adjacent-overload-signatures |
Require that member overloads be consecutive | ✔️ | ||
@typescript-eslint/array-type |
Requires using either T[] or Array<T> for arrays |
🔧 | ||
@typescript-eslint/await-thenable |
Disallows awaiting a value that is not a Thenable | ✔️ | 💭 | |
@typescript-eslint/ban-ts-comment |
Bans // @ts-<directive> comments from being used |
|||
@typescript-eslint/ban-types |
Bans specific types from being used | ✔️ | 🔧 | |
@typescript-eslint/consistent-type-assertions |
Enforces consistent usage of type assertions | ✔️ | ||
@typescript-eslint/consistent-type-definitions |
Consistent with type definition either interface or type |
🔧 | ||
@typescript-eslint/explicit-function-return-type |
Require explicit return types on functions and class methods | ✔️ | ||
@typescript-eslint/explicit-member-accessibility |
Require explicit accessibility modifiers on class properties and methods | |||
@typescript-eslint/explicit-module-boundary-types |
Require explicit return and argument types on exported functions' and classes' public class methods | |||
@typescript-eslint/member-delimiter-style |
Require a specific member delimiter style for interfaces and type literals | ✔️ | 🔧 | |
@typescript-eslint/member-ordering |
Require a consistent member declaration order | |||
@typescript-eslint/naming-convention |
Enforces naming conventions for everything across a codebase | 💭 | ||
@typescript-eslint/no-dynamic-delete |
Disallow the delete operator with computed key expressions | 🔧 | ||
@typescript-eslint/no-empty-interface |
Disallow the declaration of empty interfaces | ✔️ | 🔧 | |
@typescript-eslint/no-explicit-any |
Disallow usage of the any type |
✔️ | 🔧 | |
@typescript-eslint/no-extra-non-null-assertion |
Disallow extra non-null assertion | |||
@typescript-eslint/no-extraneous-class |
Forbids the use of classes as namespaces | |||
@typescript-eslint/no-floating-promises |
Requires Promise-like values to be handled appropriately | 💭 | ||
@typescript-eslint/no-for-in-array |
Disallow iterating over an array with a for-in loop | ✔️ | 💭 | |
@typescript-eslint/no-implied-eval |
Disallow the use of eval() -like methods |
💭 | ||
@typescript-eslint/no-inferrable-types |
Disallows explicit type declarations for variables or parameters initialized to a number, string, or boolean | ✔️ | 🔧 | |
@typescript-eslint/no-misused-new |
Enforce valid definition of new and constructor |
✔️ | ||
@typescript-eslint/no-misused-promises |
Avoid using promises in places not designed to handle them | ✔️ | 💭 | |
@typescript-eslint/no-namespace |
Disallow the use of custom TypeScript modules and namespaces | ✔️ | ||
@typescript-eslint/no-non-null-asserted-optional-chain |
Disallows using a non-null assertion after an optional chain expression | |||
@typescript-eslint/no-non-null-assertion |
Disallows non-null assertions using the ! postfix operator |
✔️ | ||
@typescript-eslint/no-parameter-properties |
Disallow the use of parameter properties in class constructors | |||
@typescript-eslint/no-require-imports |
Disallows invocation of require() |
|||
@typescript-eslint/no-this-alias |
Disallow aliasing this |
✔️ | ||
@typescript-eslint/no-throw-literal |
Disallow throwing literals as exceptions | 💭 | ||
@typescript-eslint/no-type-alias |
Disallow the use of type aliases | |||
@typescript-eslint/no-unnecessary-condition |
Prevents conditionals where the type is always truthy or always falsy | 🔧 | 💭 | |
@typescript-eslint/no-unnecessary-qualifier |
Warns when a namespace qualifier is unnecessary | 🔧 | 💭 | |
@typescript-eslint/no-unnecessary-type-arguments |
Enforces that type arguments will not be used if not required | 🔧 | 💭 | |
@typescript-eslint/no-unnecessary-type-assertion |
Warns if a type assertion does not change the type of an expression | ✔️ | 🔧 | 💭 |
@typescript-eslint/no-unused-vars-experimental |
Disallow unused variables and arguments | 💭 | ||
@typescript-eslint/no-var-requires |
Disallows the use of require statements except in import statements | ✔️ | ||
@typescript-eslint/prefer-as-const |
Prefer usage of as const over literal type |
🔧 | ||
@typescript-eslint/prefer-for-of |
Prefer a ‘for-of’ loop over a standard ‘for’ loop if the index is only used to access the array being iterated | |||
@typescript-eslint/prefer-function-type |
Use function types instead of interfaces with call signatures | 🔧 | ||
@typescript-eslint/prefer-includes |
Enforce includes method over indexOf method |
✔️ | 🔧 | 💭 |
@typescript-eslint/prefer-namespace-keyword |
Require the use of the namespace keyword instead of the module keyword to declare custom TypeScript modules |
✔️ | 🔧 | |
@typescript-eslint/prefer-nullish-coalescing |
Enforce the usage of the nullish coalescing operator instead of logical chaining | 🔧 | 💭 | |
@typescript-eslint/prefer-optional-chain |
Prefer using concise optional chain expressions instead of chained logical ands | 🔧 | ||
@typescript-eslint/prefer-readonly |
Requires that private members are marked as readonly if they're never modified outside of the constructor |
🔧 | 💭 | |
@typescript-eslint/prefer-regexp-exec |
Enforce that RegExp#exec is used instead of String#match if no global flag is provided |
✔️ | 💭 | |
@typescript-eslint/prefer-string-starts-ends-with |
Enforce the use of String#startsWith and String#endsWith instead of other equivalent methods of checking substrings |
✔️ | 🔧 | 💭 |
@typescript-eslint/promise-function-async |
Requires any function or method that returns a Promise to be marked async | 💭 | ||
@typescript-eslint/require-array-sort-compare |
Requires Array#sort calls to always provide a compareFunction |
💭 | ||
@typescript-eslint/restrict-plus-operands |
When adding two variables, operands must both be of type number or of type string | 💭 | ||
@typescript-eslint/restrict-template-expressions |
Enforce template literal expressions to be of string type | 💭 | ||
@typescript-eslint/strict-boolean-expressions |
Restricts the types allowed in boolean expressions | 💭 | ||
@typescript-eslint/triple-slash-reference |
Sets preference level for triple slash directives versus ES6-style import declarations | ✔️ | ||
@typescript-eslint/type-annotation-spacing |
Require consistent spacing around type annotations | ✔️ | 🔧 | |
@typescript-eslint/typedef |
Requires type annotations to exist | |||
@typescript-eslint/unbound-method |
Enforces unbound methods are called with their expected scope | ✔️ | 💭 | |
@typescript-eslint/unified-signatures |
Warns for any two overloads that could be unified into one by using a union or an optional/rest parameter |
In some cases, ESLint provides a rule itself, but it doesn't support TypeScript syntax; either it crashes, or it ignores the syntax, or it falsely reports against it. In these cases, we create what we call an extension rule; a rule within our plugin that has the same functionality, but also supports TypeScript.
Key: ✔️ = recommended, 🔧 = fixable, 💭 = requires type information
Name | Description | ✔️ | 🔧 |
---|---|---|---|
@typescript-eslint/adjacent-overload-signatures |
Require that member overloads be consecutive (adjacent-overload-signatures from TSLint) |
✔️ | |
@typescript-eslint/array-type |
Requires using either T[] or Array<T> for arrays (array-type from TSLint) |
✔️ | 🔧 |
@typescript-eslint/ban-types |
Enforces that types will not to be used (ban-types from TSLint) |
✔️ | 🔧 |
@typescript-eslint/no-unnecessary-boolean-literal-compare |
Flags unnecessary equality comparisons against booleans (no-boolean-literal-compare from TSLint) |
✔️ | |
@typescript-eslint/camelcase |
Enforce camelCase naming convention | ✔️ | |
@typescript-eslint/class-name-casing |
Require PascalCased class and interface names (class-name from TSLint) |
✔️ | |
@typescript-eslint/explicit-function-return-type |
Require explicit return types on functions and class methods | ✔️ | |
@typescript-eslint/explicit-member-accessibility |
Require explicit accessibility modifiers on class properties and methods (member-access from TSLint) |
✔️ | |
@typescript-eslint/generic-type-naming |
Enforces naming of generic type variables | ||
@typescript-eslint/indent |
Enforce consistent indentation (indent from TSLint) |
✔️ | 🔧 |
@typescript-eslint/interface-name-prefix |
Require that interface names be prefixed with I (interface-name from TSLint) |
✔️ | |
@typescript-eslint/member-delimiter-style |
Require a specific member delimiter style for interfaces and type literals | ✔️ | 🔧 |
@typescript-eslint/member-naming |
Enforces naming conventions for class members by visibility. | ||
@typescript-eslint/member-ordering |
Require a consistent member declaration order (member-ordering from TSLint) |
||
@typescript-eslint/no-angle-bracket-type-assertion |
Enforces the use of as Type assertions instead of <Type> assertions (no-angle-bracket-type-assertion from TSLint) |
✔️ | |
@typescript-eslint/no-array-constructor |
Disallow generic Array constructors |
✔️ | 🔧 |
@typescript-eslint/no-empty-interface |
Disallow the declaration of empty interfaces (no-empty-interface from TSLint) |
✔️ | |
@typescript-eslint/no-explicit-any |
Disallow usage of the any type (no-any from TSLint) |
✔️ | |
@typescript-eslint/no-extraneous-class |
Forbids the use of classes as namespaces (no-unnecessary-class from TSLint) |
||
@typescript-eslint/no-for-in-array |
Disallow iterating over an array with a for-in loop (no-for-in-array from TSLint) |
||
@typescript-eslint/no-inferrable-types |
Disallows explicit type declarations for variables or parameters initialized to a number, string, or boolean. (no-inferrable-types from TSLint) |
✔️ | 🔧 |
@typescript-eslint/no-misused-new |
Enforce valid definition of new and constructor . (no-misused-new from TSLint) |
✔️ | |
@typescript-eslint/no-namespace |
Disallow the use of custom TypeScript modules and namespaces (no-namespace from TSLint) |
✔️ | |
@typescript-eslint/no-non-null-assertion |
Disallows non-null assertions using the ! postfix operator (no-non-null-assertion from TSLint) |
✔️ | |
@typescript-eslint/no-object-literal-type-assertion |
Forbids an object literal to appear in a type assertion expression (no-object-literal-type-assertion from TSLint) |
✔️ | |
@typescript-eslint/no-parameter-properties |
Disallow the use of parameter properties in class constructors. (no-parameter-properties from TSLint) |
✔️ | |
@typescript-eslint/no-require-imports |
Disallows invocation of require() (no-require-imports from TSLint) |
✔️ | |
@typescript-eslint/no-this-alias |
Disallow aliasing this (no-this-assignment from TSLint) |
||
@typescript-eslint/no-triple-slash-reference |
Disallow /// <reference path="" /> comments (no-reference from TSLint) |
✔️ | |
@typescript-eslint/no-type-alias |
Disallow the use of type aliases (interface-over-type-literal from TSLint) |
||
@typescript-eslint/no-unnecessary-type-assertion |
Warns if a type assertion does not change the type of an expression (no-unnecessary-type-assertion from TSLint) |
🔧 | |
@typescript-eslint/no-unused-vars |
Disallow unused variables (no-unused-variable from TSLint) |
✔️ | |
@typescript-eslint/no-use-before-define |
Disallow the use of variables before they are defined | ✔️ | |
@typescript-eslint/no-useless-constructor |
Disallow unnecessary constructors | ||
@typescript-eslint/no-var-requires |
Disallows the use of require statements except in import statements (no-var-requires from TSLint) |
✔️ | |
@typescript-eslint/prefer-function-type |
Use function types instead of interfaces with call signatures (callable-types from TSLint) |
🔧 | |
@typescript-eslint/prefer-interface |
Prefer an interface declaration over a type literal (type T = { ... }) (interface-over-type-literal from TSLint) |
✔️ | 🔧 |
@typescript-eslint/prefer-namespace-keyword |
Require the use of the namespace keyword instead of the module keyword to declare custom TypeScript modules. (no-internal-module from TSLint) |
✔️ | 🔧 |
@typescript-eslint/promise-function-async |
Requires any function or method that returns a Promise to be marked async. (promise-function-async from TSLint) |
✔️ | |
@typescript-eslint/restrict-plus-operands |
When adding two variables, operands must both be of type number or of type string. (restrict-plus-operands from TSLint) |
||
@typescript-eslint/type-annotation-spacing |
Require consistent spacing around type annotations (typedef-whitespace from TSLint) |
✔️ | 🔧 |