回调为什么不能替换:函数兼容性

从替换函数是否安全出发,理解参数逆变、返回值协变、上下文类型与回调类型复用。

本章目录CONTENTS ↓

批处理函数会把字符串或数字交给格式化回调。现在有一个只会处理数字的回调,能否放进去?虽然它接受的类型更具体,但批处理仍可能传入字符串,此时实现就接不住。

要判断函数类型能否赋值,必须站在调用方看允许的输入,再检查实际实现能否兑现输出。由这个替换问题推导参数与结果的兼容方向。以下使用 strict 下的普通函数类型。

用替换是否安全判断方向

type Format = (value: string | number) => string;
const formatNumber = (value: number): string => value.toFixed(2);
const formatAnything = (value: unknown): string => String(value);
// @ts-expect-error Format 允许传入字符串,实际实现处理不了
const narrow: Format = formatNumber;
const broad: Format = formatAnything;
const output: string = broad("hello");

目标 Format 允许的每一种输入,实际函数都必须能处理。formatAnything 能接收 unknown,覆盖了目标允许的输入;formatNumber 只会处理数字,无法满足目标的字符串输入。

unknown 能接收所有值,但使用具体方法前仍需收窄。“接受范围宽”与“可以不检查就任意操作”是两回事。

比较位置 要满足的关系 常见术语
输入 目标允许的输入,实际参数类型必须接得住。 参数逆变
输出 实际返回的值,必须满足目标承诺。 返回值协变
const source = (value: unknown): string => String(value);
const flexibleResult: (value: number) => string | number = source;
// @ts-expect-error 输入兼容,但返回 string 不满足 number
const wrongResult: (value: number) => number = source;

可以接收更宽输入、给出更具体结果,是这里判断安全替换的方向。参数和返回值要同时通过。方法与构造声明存在检查例外,不能把普通函数的规则不加区分地推广到所有声明形式。

在真实 API 中实现并复用回调

function processValues(
values: (string | number)[],
format: (value: string | number) => string
): string[] {
return values.map(format);
}
const inline = processValues([12.3, " hello "], value =>
typeof value === "number" ? value.toFixed(2) : value.trim()
);
// ["12.30", "hello"]
type Formatter = Parameters<typeof processValues>[1];
const formatter: Formatter = value =>
typeof value === "number" ? value.toFixed(2) : value.trim();
const reused = processValues([12.3, " hello "], formatter);

内联回调的 value 从所在位置获得上下文类型。抽离后的 formatter 则通过变量标注得到相同上下文;没有这些上下文或参数标注时,独立箭头函数的参数会成为隐式 any,严格检查将报错。后续把函数传给 API,不会反过来补全它声明时缺失的类型。

Parameters<typeof processValues>[1] 先取得外层函数的参数元组,再取第二项回调类型。回调返回 string,外层 API 返回 string[],读取声明时要先确定自己正在看哪一层函数。

void 表示调用侧不依赖返回结果

const makeLabel = () => "saved";
const notify: () => void = makeLabel;
const ignored = notify(); // 静态类型 void,运行时仍返回 "saved"
const collected: number[] = [];
[1, 2].forEach(value => collected.push(value));
// @ts-expect-error 显式标注实现返回 void,不能返回字符串表达式
const explicit = (): void => "saved";
// @ts-expect-error notify 的签名不承诺返回 string
const readLabel: () => string = notify;

目标类型为返回 void 的函数时,可以接收返回其他值的实现。赋值不会改变运行时行为,只是通过目标签名调用时,结果被视为 void。这个特殊规则不适用于把 string 值直接赋给 void,也不免除参数兼容性检查。

如果 API 确实需要回调结果,应声明实际结果类型;使用 any 会丢掉约束,不能准确表达“忽略结果”。

报错时找一个反例调用

与其背赋值箭头,不如构造目标允许、实现却接不住的输入;找不到输入问题时,再看输出承诺。赋值成功后,调用仍按变量当前签名检查,不会自动开放实现支持的全部输入。

参数数量、可选性和默认值集中在可选参数与配置默认值。机制查阅:函数兼容性、strictFunctionTypes、上下文类型和 void 返回规则。回到全景。

这一页,先记到这里。