从已有函数取出类型: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>; // never

T 是整个输入类型;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。实际包装与转发见函数包装,回到全景。

这一页,先记到这里。