从已有函数取出类型:infer 与元组
从结构中提取属性、参数列表与返回类型,并理解位置和使用边界。
本章目录CONTENTS ↓
给现有搜索函数保存一条待执行调用,需要知道参数列表;给结果建立缓存条目,又需要知道返回类型。把这些类型重新手写一次,函数改动后就可能失配。只取得整个函数类型还不够,我们需要从结构中取出所需部分。
已知对象键时可以直接索引;函数的参数和返回位置则可以通过结构匹配提取。先用 Parameters 和 ReturnType 解决需求,再打开它们背后的条件匹配与 infer 机制。
先用已有签名解决实际需求
function search(query: string, limit = 20): string[] { return [query].slice(0, limit);}
type Search = typeof search;type SearchArgs = Parameters<Search>;// [query: string, limit?: number]type SearchResult = ReturnType<Search>; // string[]
const args: SearchArgs = ["typescript"];const result: SearchResult = search(...args);typeof search 在类型位置取得已有值的类型;Parameters 读取整个参数元组,ReturnType 读取返回类型。这个过程不会调用 search。
参数列表需要保留位置、数量和可选性,故使用元组。(string | number)[] 允许任意数量和排列,不能代替这里的 [string, number?]。元组标签用于阅读,不改变位置约束。
用结构匹配同时提取多个部分
当结果不仅是单独的参数或返回类型,而是新的业务结构,可以使用条件类型与 infer 组合。
type FunctionParts<T> = T extends (...args: infer P) => infer R ? { parameters: P; result: R } : never;
type Parts = FunctionParts<Search>;// { parameters: [query: string, limit?: number]; result: string[] }type Empty = FunctionParts<() => number>;// { parameters: []; result: number }type NotFunction = FunctionParts<string>; // neverT 是整个输入类型;P 匹配参数列表,R 匹配返回位置;真分支用两者构造输出,假分支决定不匹配时的处理策略。空参数列表仍然是函数结构,不能与匹配失败混淆。
infer 声明在条件类型 extends 右侧的匹配结构内,推导出的变量在真分支可用。它不要求外层一定有泛型,只是泛型让规则可以复用。内置 Parameters 对输入有函数约束;本例则主动选择让非函数得到 never。
信息从哪里来,就在哪个位置匹配
| 需要的信息 | 表达方式 | 适用边界 |
|---|---|---|
| 已知对象属性 | T["payload"] |
输入已经保证有该属性。 |
| 先确认结构再取属性 | T extends { payload: infer P } ? P : never |
条件负责决定不匹配如何处理。 |
| 函数参数列表 | Parameters<F> |
优先复用现有工具。 |
| 第一个参数 | Parameters<F>[0] |
先约定函数是否可能无参或首参可选。 |
| 参数与结果的新组合 | 同时 infer P、infer R |
需要保留同一函数内的关联。 |
type PayloadOf<T> = T extends { payload: infer P } ? P : never;type Payload = PayloadOf<{ payload: { id: string } }>;// { id: string }为“读取某部分”引入 infer,而不是为显得通用而重新实现每个内置工具。如果项目已经导出独立的业务类型,直接引用往往比从某个实现反推更清晰。
联合输入:先提取并配对,再合并
type Convert = ((text: string) => number) | ((value: number) => string);type ConversionParts = FunctionParts<Convert>;// { parameters: [text: string]; result: number }// | { parameters: [value: number]; result: string }分配由条件左侧的裸参数 T 触发;infer 决定从每个成员的什么位置提取。每次匹配同时生成参数与结果,因此关联仍在。如果分别取参数联合、结果联合再组装,就会允许交叉配对。完整应用见API 测试用例建模。
这些例子限定单个普通函数签名。重载提取通常依据最后一个签名,并不是模拟某次调用选择重载;泛型函数也可能提取成较宽类型。遇到这些情形,应查看实际展开类型与官方 Utility Types,不能假定所有关联都能完整恢复。
机制入口:Inferring Within Conditional Types。实际包装与转发见函数包装,回到全景。
这一页,先记到这里。