69 lines
1.8 KiB
Plaintext
69 lines
1.8 KiB
Plaintext
---
|
|
description: 'Disallow calling a value with type `any`.'
|
|
---
|
|
|
|
> 🛑 This file is source code, not the primary documentation location! 🛑
|
|
>
|
|
> See **https://typescript-eslint.io/rules/no-unsafe-call** for documentation.
|
|
|
|
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.
|
|
|
|
Despite your best intentions, the `any` type can sometimes leak into your codebase.
|
|
Calling an `any`-typed value as a function creates a potential type safety hole and source of bugs in your codebase.
|
|
|
|
This rule disallows calling any value that is typed as `any`.
|
|
|
|
## Examples
|
|
|
|
<!--tabs-->
|
|
|
|
### ❌ Incorrect
|
|
|
|
```ts
|
|
declare const anyVar: any;
|
|
declare const nestedAny: { prop: any };
|
|
|
|
anyVar();
|
|
anyVar.a.b();
|
|
|
|
nestedAny.prop();
|
|
nestedAny.prop['a']();
|
|
|
|
new anyVar();
|
|
new nestedAny.prop();
|
|
|
|
anyVar`foo`;
|
|
nestedAny.prop`foo`;
|
|
```
|
|
|
|
### ✅ Correct
|
|
|
|
```ts
|
|
declare const typedVar: () => void;
|
|
declare const typedNested: { prop: { a: () => void } };
|
|
|
|
typedVar();
|
|
typedNested.prop.a();
|
|
|
|
(() => {})();
|
|
|
|
new Map();
|
|
|
|
String.raw`foo`;
|
|
```
|
|
|
|
## When Not To Use It
|
|
|
|
If your codebase has many existing `any`s or areas of unsafe code, it may be difficult to enable this rule.
|
|
It may be easier to skip the `no-unsafe-*` rules pending increasing type safety in unsafe areas of your project.
|
|
You might consider using [ESLint disable comments](https://eslint.org/docs/latest/use/configure/rules#using-configuration-comments-1) for those specific situations instead of completely disabling this rule.
|
|
|
|
## Related To
|
|
|
|
- [`no-explicit-any`](./no-explicit-any.md)
|
|
- [`no-unsafe-argument`](./no-unsafe-argument.md)
|
|
- [`no-unsafe-assignment`](./no-unsafe-assignment.md)
|
|
- [`no-unsafe-member-access`](./no-unsafe-member-access.md)
|
|
- [`no-unsafe-return`](./no-unsafe-return.md)
|