本文详解 typescript 中如何定义并实例化具有多个调用签名（overloads）且携带属性的函数类型，通过具体代码演示合法赋值方式、类型安全要点及常见误区。

本文详解 typescript 中如何定义并实例化具有多个调用签名（overloads）且携带属性的函数类型，通过具体代码演示合法赋值方式、类型安全要点及常见误区。

在 TypeScript 中，函数类型不仅可以描述调用行为，还能兼具对象特性——即同时拥有调用签名（call signatures）和自有属性。你定义的 MyFunction 类型正是一个典型示例：

type MyFunction = {
  (x: any): boolean;
  (x: any, y: any): boolean;
  desc: string;
};

该类型声明了一个可被两种方式调用的函数（单参数或双参数），并要求其必须具备 desc: string 属性。值得注意的是：TypeScript 的函数类型重载仅在类型检查阶段生效，不生成运行时重载逻辑；实际实现必须兼容所有签名（通常通过可选参数或联合参数处理）。

✅ 正确的实例化方式如下：

Scrapfly SDK TypeScript

使用 Scrapfly SDK（scrapfly-sdk）在 TypeScript 或 JavaScript 中进行网页抓取，用于用户请求抓取 URL、绕过反爬虫防护、渲染页面等场景。

下载

const myFunction: MyFunction = (x: any, y?: any): boolean => {
  // 兼容两种调用：f(x) 和 f(x, y)
  return true;
};

// 必须显式添加 required 属性
myFunction.desc = "Brian’s custom function";

⚠️ 关键注意事项：

• 实现函数必须能安全响应所有签名：这里使用 y?（可选参数）确保 (x) 和 (x, y) 均可调用，否则类型检查会失败；
• 属性需手动赋值：函数字面量本身不包含 desc，必须在赋值后单独设置，且类型系统会校验其存在性与类型；
• ❌ 错误示例（编译报错）：

  const bad: MyFunction = (x: number) => x > 0; // 缺少 desc，且不支持双参调用

• ✅ 进阶技巧：可结合 as const 或辅助函数封装初始化逻辑，提升复用性：

function createMyFunction(
  impl: (x: any, y?: any) => boolean,
  description: string
): MyFunction {
  const fn = impl as MyFunction;
  fn.desc = description;
  return fn;
}

const safeFn = createMyFunction((a, b) => !!b, "Checks if second arg exists");

总结：这种“函数 + 属性”类型是 TypeScript 强大类型表达能力的体现，适用于插件接口、带元信息的工具函数等场景。只要实现满足所有调用签名的兼容性，并补全必需属性，即可安全使用。