第39章 Parameters工具类型
案例39:Parameters工具类型——提取函数参数元组类型
题目:在TypeScript中,使用Parameters<T>工具类型获取一个函数的参数元组类型,并基于此构建类型安全的回调包装器,避免手写重复的参数类型声明。
设计思路
当我们需要包装一个现有函数(如日志记录、延迟执行)时,往往希望包装器与原函数拥有完全一致的参数签名。Parameters<T>能自动提取函数类型T的参数元组,配合...展开语法实现零重复的类型定义。
核心代码
// 定义一个需要被包装的实际函数
function fetchUser(id: number, verbose: boolean): string {
return verbose ? `用户${id}详情` : `ID:${id}`;
}
// 使用Parameters提取参数元组类型
type FetchParams = Parameters<typeof fetchUser>;
// 包装器:参数类型自动同步
function withLogging(...args: FetchParams): string {
console.log('[调用参数]', ...args);
return fetchUser(...args);
}
// 进阶:完全泛型化包装器
function timed<T extends (...args: any[]) => any>(
fn: T,
...args: Parameters<T>
): ReturnType<T> {
console.time('执行耗时');
const result = fn(...args);
console.timeEnd('执行耗时');
return result;
}
// 调用验证
const result = withLogging(101, true);
const timedResult = timed(fetchUser, 202, false);
console.log(result, timedResult);
运行结果验证
运行上述代码(使用ts-node或tsc编译后执行),控制台输出:
[调用参数] 101 true
执行耗时: 0.1ms
用户101详情 ID:202
测试建议
尝试修改fetchUser的参数数量或类型,观察withLogging和timed是否自动适应。若传入错误参数,编译器会立即报错,无需手动修改包装器。
常见问题
注意:Parameters<T>只能用于函数类型,如果T不是函数会报错。另外,对于重载函数,它提取的是最后一个重载签名的参数。
成功要点
掌握Parameters与ReturnType的配合使用,可以将“任何函数”的签名完整保留到包装器中,极大减少类型维护成本,是编写高阶函数时的核心工具。