JavaScript / TypeScript / 系统课时

定义回调函数类型

定义回调函数类型

回调函数类型用于约束“传入的函数应该接收什么参数、返回什么结果”。定义清晰的回调签名后,调用者能获得参数提示,函数内部也不必依赖 any 猜测数据形状。

学习目标

  • 使用函数类型别名声明回调的参数与返回值
  • 在高阶函数中让回调获得上下文类型推断
  • 避免使用 Function、any 或过宽的可选参数

回调类型的核心写法

函数类型的基本形式是 (参数名: 类型) => 返回类型。参数名主要用于阅读和编辑器提示,类型兼容性取决于参数位置、参数类型和返回类型,而不是参数名是否相同。

下面定义价格格式化回调,并把它传给批量处理函数:

ts
// 类型别名集中描述回调协议,便于多个函数复用
type PriceFormatter = (price: number, currency: string) => string;

function renderPrices(
  prices: number[],
  formatter: PriceFormatter
): string[] {
  // 调用点严格按照约定传入价格和币种
  return prices.map((price) => formatter(price, "CNY"));
}

const formatCurrency: PriceFormatter = (value, currency) => {
  return `${currency} ${value.toFixed(2)}`;
};

console.log(renderPrices([12, 35.5], formatCurrency));

预期输出

text
[ 'CNY 12.00', 'CNY 35.50' ]

formatCurrency 的参数没有重复标注类型,因为变量已经声明为 PriceFormatter,TypeScript 会根据上下文把 value 推断为 number、把 currency 推断为 string。

不要把签名声明得过宽

Function 只表示“这是一个函数”,无法检查参数和返回值;(...args: any[]) => any 虽然灵活,却会关闭关键的类型检查。已知业务协议时,应准确写出每个参数和返回值。

只有数据来源确实未知时才考虑 unknown,并在回调内部缩小类型。若回调需要保持输入与输出之间的对应关系,通常应使用泛型,而不是把两端都改成联合类型或 any。

正确理解 void 回调

返回类型为 void 表示调用方不会使用返回值,并不强制实现函数绝对不能返回内容。因此,一个返回数字的函数可以用于 () => void 的位置,但该数字会被忽略。

事件处理器、数组遍历和通知钩子常用 void。若返回值代表是否继续、转换结果或异步结果,就应声明真实类型,例如 boolean、string 或 Promise<void>,不要用 void 掩盖协议。

可选参数与严格检查

不要为了“兼容更多函数”随意把回调参数写成可选参数。index?: number 意味着调用者可以不传索引,回调实现就必须处理 undefined;如果框架每次都会传入索引,应写成 index: number。

开启 strictFunctionTypes 后,参数范围过窄的回调会被拒绝。例如要求处理所有 Animal 的位置,不能传入一个只接受 Dog 的函数,否则运行时可能收到无法处理的其他动物。

本课总结

  • 用明确的 (参数) => 返回值 描述回调协议,并通过类型别名复用
  • 利用上下文类型减少重复标注,同时保留完整的参数提示
  • 避免 Function、any 和无依据的可选参数,void 只表示返回值被忽略

下一课预告

下一课将学习函数重载:为同一个函数声明多组可调用签名,并让实现同时兼容所有参数组合。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义回调函数类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通