0Pricing
TypeScript Academy · 课时

函数重载与调用签名

为不同的调用形式声明重载签名，并在对象类型中使用调用签名来构建灵活的 API。

函数重载与调用签名 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 1 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 3 节课。

简介

目标：使用重载为接受不同输入并返回不同输出的函数建模，并在对象类型中描述调用签名，以支持类似回调的 API。

重载模式

重载由多个签名和一个实现组成；该实现会收窄输入并返回正确的类型。

// 1) Overload signatures (no body)
function parse(input: string): number;
function parse(input: number): string;
// 2) Single implementation compatible with all overloads
function parse(input: string | number): string | number {
  if (typeof input === "string") {
    return input.length; // string -> number
  } else {
    return String(input); // number -> string
  }
}

console.log(parse("TS"));   // 2 (number)
console.log(parse(123));    // "123" (string)

调用签名

调用签名允许对象类型通过重载进行调用（适用于公开可调用函数及其属性的库）。

type Stringify = {
  (v: number): string;
  (v: boolean): string;
};

const toStr: Stringify = (v: number | boolean) => {
  return typeof v === "number" ? v.toFixed(1) : (v ? "true" : "false");
};

console.log(toStr(3));
console.log(toStr(false));

实现中的类型收窄

实现必须处理所有重载形式。请使用 in 检查或判别联合类型来安全地进行分支处理。

function area(value: { r: number } | { w: number; h: number }): number {
  if ("r" in value) {
    return Math.PI * value.r ** 2; // circle
  }
  return value.w * value.h; // rect
}

console.log(area({ r: 2 }));
console.log(area({ w: 3, h: 4 }));

重载与联合类型

重载与联合类型：

  • 重载为每次调用提供精确的返回类型。
  • 联合类型只保留一个签名，实现更简单，但具体性较低。
  • 当调用方能够从精确的返回类型中受益时，请选择重载。

DX 提示

提示：

  • 请让重载数量保持少而清晰。
  • 请记录参数和返回值之间的差异。
  • 如果返回类型的精确性能够改善用户体验，请优先考虑它。

重载检查

快速检查：哪种模式能够正确声明函数重载？

回顾

回顾：请使用重载来表示每次调用的精确类型，并使用调用签名来建模可调用对象。在单一实现中进行类型收窄，以覆盖所有情况。

常见问题解答

「函数重载与调用签名」课时是免费的吗？

是的 — 「函数重载与调用签名」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 3 节课。

「函数重载与调用签名」这节课中我会学到什么？

为不同的调用形式声明重载签名，并在对象类型中使用调用签名来构建灵活的 API。 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 3 节。

「函数重载与调用签名」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 函数重载与调用签名
  2. this 参数类型；void 与 never
  3. 断言函数与用户自定义类型守卫
← 返回 TypeScript Academy