包装之后仍能推导:参数与结果变换
从完整包装器理解参数与返回值的关联,保留调用契约,并将同步异常转换为明确的结果模型。
本章目录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); // 此处尚未执行 formatconst 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,结果模型见请求状态,阅读路线见全景。
这一页,先记到这里。