什么是Typescript的方法重载?
参考答案
概念
方法重载(overload)是同一个函数/方法声明多个签名、共用一份实现的能力,用于表达"参数不同、返回类型不同"的调用方式。
function pad(value: string, len: number): string;
function pad(value: number, len: number): number;
function pad(value: string | number, len: number): string | number {
const s = String(value);
return typeof value === 'number' ? Number(s.padStart(len, '0')) : s.padStart(len, '0');
}
规则
- 多个签名 + 一个实现签名,实现签名必须兼容所有重载签名(参数类型用联合、返回值用联合)。
- 实现签名对外不可见,调用方只能匹配前面的重载签名。
- 调用时从上到下匹配第一个符合的签名,所以更具体的签名放前面(如
(x: string)在(x: any)之前)。 - 重载签名必须连续书写,中间不能插入其他成员(类里也一样)。
类方法重载
class Fetcher {
get(url: string): Promise<Response>;
get(url: string, timeout: number): Promise<Response>;
get(url: string, timeout?: number): Promise<Response> {
return fetch(url, { signal: AbortSignal.timeout(timeout ?? 5000) });
}
}
与"重写"的区别
- 重载 overload:同名、不同签名、同一实现,编译期概念。
- 重写 override:子类覆盖父类同名方法,运行时概念。
注意
- TS 的重载是纯类型层面的,编译后只有一个函数;不支持按参数类型做真正的运行时分发。
- 箭头函数属性不能写重载(需用类型交叉或接口声明)。
ReturnType对重载函数只取最后一个签名。- 重载过多时可读性差,优先考虑联合类型 + 判别参数,或泛型。