useUnifiedTypeSignatures

TypeScript and TSX

摘要

¥Summary

规则生效日期：v2.1.0

¥Rule available since: v2.1.0
诊断类别：lint/style/useUnifiedTypeSignatures

¥Diagnostic Category: lint/style/useUnifiedTypeSignatures
此规则包含 unsafe 修复程序。

¥This rule has an unsafe fix.
此规则的默认严重级别为 information。

¥The default severity of this rule is information.
来源：

¥Sources:
- 与 @typescript-eslint/unified-signatures 相同
  
  ¥Same as @typescript-eslint/unified-signatures

如何配置

¥How to configure

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

描述

¥Description

禁止使用可以合并为单个签名的重载签名。

¥Disallow overload signatures that can be unified into a single signature.

可以合并为单个签名的重载签名是冗余的，应该避免。此规则通过将参数设为可选和/或使用类型联合来合并重载，从而简化函数签名。

¥Overload signatures that can be merged into a single signature are redundant and should be avoided. This rule helps simplify function signatures by combining overloads by making parameters optional and/or using type unions.

示例

¥Examples

无效

¥Invalid

1
function f(a: number): void;
2
function f(a: string): void;

code-block.ts:1:1 lint/style/useUnifiedTypeSignatures  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Multiple similar overload signatures are hard to read and maintain.
  
  > 1 │ function f(a: number): void;
      │ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    2 │ function f(a: string): void;
    3 │ 
  
  ℹ Unsafe fix: Combine overloads using a type union.
  
    1   │ - function·f(a:·number):·void;
    2   │ - function·f(a:·string):·void;
      1 │ + 
      2 │ + function·f(a:·string·|·number):·void;
    3 3 │

1
interface I {
2
    a(): void;
3
    a(x: number): void;
4
}

code-block.ts:2:5 lint/style/useUnifiedTypeSignatures  FIXABLE  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Multiple similar overload signatures are hard to read and maintain.
  
    1 │ interface I {
  > 2 │     a(): void;
      │     ^^^^^^^^^^
    3 │     a(x: number): void;
    4 │ }
  
  ℹ Unsafe fix: Combine overloads by making parameters optional.
  
    1 1 │   interface I {
    2   │ - ····a():·void;
    3   │ - ····a(x:·number):·void;
      2 │ + ····a(x?:·number):·void;
    4 3 │   }
    5 4 │

有效

¥Valid

1
function f(a: number | string): void {}

1
interface I {
2
    a(x?: number): void;
3
}

不同返回类型不能合并：

¥Different return types cannot be merged:

1
interface I {
2
    f(): void;
3
    f(x: number): number;
4
}

不同类型参数不能合并：

¥Different type parameters cannot be merged:

1
function f<T extends number>(x: T): void;
2
function f<T extends string>(x: T): void;
3
function f(x: unknown): void {}

useUnifiedTypeSignatures

摘要

如何配置

描述

示例

无效

有效

相关链接