noExplicitAny

TypeScript and TSX

Summary

Rule available since: v1.0.0
Diagnostic Category: lint/suspicious/noExplicitAny
This rule is recommended, which means is enabled by default.
This rule doesn’t have a fix.
The default severity of this rule is error.
Sources:
- Same as @typescript-eslint/no-explicit-any

Description

Disallow the any type usage.

The any type in TypeScript is a dangerous “escape hatch” from the type system. Using any disables many type checking rules and is generally best used only as a last resort or when prototyping code.

TypeScript’s --noImplicitAny compiler option prevents an implied any, but doesn’t prevent any from being explicitly used the way this rule does.

Sometimes you can use the type unknown instead of the type any. It also accepts any value, however it requires to check that a property exists before calling it.

Examples

Invalid

1
let variable: any = 1;

code-block.ts:1:15 lint/suspicious/noExplicitAny ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Unexpected any. Specify a different type.
  
  > 1 │ let variable: any = 1;
      │               ^^^
    2 │ 
  
  ℹ any disables many type checking rules. Its use should be avoided.

1
class SomeClass {
2
   message: Array<Array<any>>;
3
}

code-block.ts:2:25 lint/suspicious/noExplicitAny ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Unexpected any. Specify a different type.
  
    1 │ class SomeClass {
  > 2 │    message: Array<Array<any>>;
      │                         ^^^
    3 │ }
    4 │ 
  
  ℹ any disables many type checking rules. Its use should be avoided.

1
function fn(param: Array<any>): void {}

code-block.ts:1:26 lint/suspicious/noExplicitAny ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ✖ Unexpected any. Specify a different type.
  
  > 1 │ function fn(param: Array<any>): void {}
      │                          ^^^
    2 │ 
  
  ℹ any disables many type checking rules. Its use should be avoided.

Valid

1
let variable: number = 1;
2
let variable2 = 1;

1
class SomeClass<T extends any> {
2
   message: Array<Array<unknown>>;
3
}

1
function fn(param: Array<Array<unknown>>): Array<unknown> {}

How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "suspicious": {
5
        "noExplicitAny": "error"
6
      }
7
    }
8
  }
9
}