包装之后仍能推导:参数与结果变换

从完整包装器理解参数与返回值的关联,保留调用契约,并将同步异常转换为明确的结果模型。

本章目录CONTENTS ↓

给格式化函数加日志后,原来合法的数字参数仍应合法,原来非法的字符串参数仍应报错,返回值也应继续推导为 string。若把包装后的签名写成任意参数和任意结果,这层包装就丢掉了原来的类型信息。

需要保留的是完整参数列表和结果类型:参数列表用元组 A 表示,结果用 R 表示,让原函数与新函数共享它们。若包装确实改变返回形状,就只变换 R。以下限定 strict 下普通、非重载、非泛型且不依赖 this 的函数。

保留原调用契约的日志包装

参数列表不能简单写成元素联合的数组,否则顺序、数量和可选性都会丢失。用 A extends unknown[] 允许推导出具体参数元组,再把同一个 A 放到输入函数和输出函数的 rest 参数位置;R 同样出现在两侧的返回位置。

function withLogging<A extends unknown[], R>(
fn: (...args: A) => R
): (...args: A) => R {
return (...args: A): R => {
console.log(args);
return fn(...args);
};
}
function format(value: number, digits = 2): string {
return value.toFixed(digits);
}
const loggedFormat = withLogging(format);
loggedFormat(12.5); // "12.50"
loggedFormat(12.5, 1); // "12.5"
// @ts-expect-error 包装后仍要求数字首参
loggedFormat("12.5");

A 连接原函数与新函数的参数列表,R 连接两者的返回结果。对 format,A 是包含必填 value 和可选 digits 的元组,R 是 string;调用者仍获得具体检查。

A extends unknown[] 只约束 A 必须能用作参数列表,没有把推导结果替换成 unknown[]。直接要求 fn: (...args: unknown[]) => R 则意味着函数要接得住任意 unknown 实参,数字格式化函数无法满足该要求。

运行时,外层调用创建闭包,返回的函数被调用时才执行 fn。声明中的 ...args 收集实参,调用中的 ...args 展开实参;return 负责把实际结果交还调用者。省略 return 会改变行为,类型也应相应改变。

改变返回模型:把同步异常变成结果

type Result<T> =
| { ok: true; value: T }
| { ok: false; error: unknown };
function safeWrap<A extends unknown[], R>(
fn: (...args: A) => R
): (...args: A) => Result<R> {
return (...args: A): Result<R> => {
try {
return { ok: true, value: fn(...args) };
} catch (error: unknown) {
return { ok: false, error };
}
};
}
function divide(left: number, right: number): number {
if (right === 0) throw new Error("除数不能为零");
return left / right;
}
const safeDivide = safeWrap(divide);
const success = safeDivide(6, 2); // { ok: true, value: 3 }
const result = safeDivide(6, 0); // { ok: false, error: Error 实例 }
if (result.ok) {
console.log(result.value.toFixed(2));
} else if (result.error instanceof Error) {
console.log(result.error.message);
} else {
console.log("未知异常");
}

参数 A 仍然透传,返回值从 R 变为 Result<R>,这与代码实际增加的成功/失败结构一致。成功检查确认有 value;失败检查只确认有 error;instanceof 再确认 error 能读取 message。JavaScript 允许抛出字符串等值,因此不能把所有异常直接断言为 Error。

这也说明两个层次的返回不同:safeWrap 返回一个函数,调用该函数才得到结果对象。类型参数不负责执行,真正调用时机由函数体决定。

同一关系可以产生不同包装

function withResult<A extends unknown[], R>(
fn: (...args: A) => R
): (...args: A) => { value: R } {
return (...args: A) => ({ value: fn(...args) });
}
const wrapped = withResult(format); // 此处尚未执行 format
const output = wrapped(12.5); // { value: "12.50" }
包装用途 新返回类型 运行时责任
日志 R 记录实参并返回原结果。
结果对象 { value: R } 创建对象,放入原结果。
同步异常转换 Result<R> 捕获同步抛出并区分成功与失败。

类型设计必须跟随这项责任,不能只改签名而忽略实际返回行为。

单个函数可以直接提取签名

type PageOptions = { page?: number; pageSize?: number };
function getOffset({ page = 1, pageSize = 20 }: PageOptions = {}): number {
return (page - 1) * pageSize;
}
function loggedGetOffset(...args: Parameters<typeof getOffset>) {
console.log(args);
return getOffset(...args);
}
loggedGetOffset(); // 0,日志为 []
loggedGetOffset({ page: 3 }); // 40

这里无需通用工厂,Parameters 直接提取可选对象参数元组。零参数调用被原样转发,由原函数完成默认值处理。

(...args: Tuple) 接收多个实参;([...args]: Tuple) 接收一个元组实参再解构。阅读时先看函数参数最外层的结构,不能仅因为函数体里都有数组变量就认为调用方式相同。参数细节见可选参数与默认值。

包装的边界需要明确

safeWrap 只捕获包围的同步调用。若 fn 返回 Promise,成功成员的 value 就是 Promise,之后的拒绝不会被这个同步 catch 捕获;需要异步包装时,应重新设计 await 与捕获的位置。

这些签名也不承诺保留重载集合、泛型函数内部关联、附加属性或 this 绑定。真正包装库函数时,先明确这些是否属于契约,再决定需要多复杂的类型;一个通用外观不能代替验证。

官方入口:Generic Rest Parameters、Utility Types、Unknown in Catch Variables。提取原理见infer,结果模型见请求状态,阅读路线见全景。

这一页,先记到这里。