本文详解 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 强大类型表达能力的体现，适用于插件接口、带元信息的工具函数等场景。只要实现满足所有调用签名的兼容性，并补全必需属性，即可安全使用。
