嵌套日期也要转换:递归类型
把嵌套业务对象的 Date、数组和可选字段映射为传输类型,并识别分配与运行时边界。
本章目录CONTENTS ↓
业务对象常含多层对象和数组,传输时又需要不同的表示。例如运行时的 Date 要先序列化为字符串;如果为每个订单字段手写另一套类型,很容易遗漏嵌套或可选字段。递归类型可描述这项变换的结果形状,但不会执行转换。
模型与变换规则
只在最外层映射属性,能改 createdAt,却会漏掉 items 内的 shippedAt;继续手写第二层又会遇到第三层。问题的重复部分是“对当前类型执行同一套规则”,所以把变换定义为可递归调用的类型。先约定有限的输入范围,再分 Date、数组、普通对象和不可再拆的值四类处理。
type Order = { id: string; createdAt: Date; items: { sku: string; shippedAt: Date | null; }[]; delivery?: { promisedAt: Date };};
type ToWire<T> = T extends Date ? string : T extends (infer Item)[] ? ToWire<Item>[] : T extends object ? { [K in keyof T]: ToWire<T[K]> } : T;
type WireOrder = ToWire<Order>;
const wire: WireOrder = { id: "o1", createdAt: "2026-09-24T11:11:11.000Z", items: [ { sku: "a", shippedAt: "2026-09-25T11:11:11.000Z" }, { sku: "b", shippedAt: null } ], delivery: { promisedAt: "2026-09-26T11:11:11.000Z" }};ToWire<T> 先识别 Date,再识别数组,接着映射普通对象的各个属性,最后让原始类型、null、undefined 原样返回。Date 和数组都符合 object,所以专门分支必须排在对象分支前。ToWire<Item> 与 ToWire<T[K]> 把同一规则应用到下一层;遇到不能继续拆分的值时,最后的 T 是终止条件。递归条件类型的官方例子也使用这种“继续拆容器,否则返回当前类型”的结构:Recursive Conditional Types。
为什么可选与可空字段也能转换
映射类型保留 delivery? 的可选性。读取该属性类型时,会得到 { promisedAt: Date } | undefined;递归调用 ToWire<T[K]> 后,顶层检查对象是裸类型参数 T,所以对联合的各成员分别处理:对象内部的 Date 变为 string,undefined 保留。
shippedAt 同理:ToWire<Date | null> 得到 ToWire<Date> | ToWire<null>,即 string | null。如果直接在映射内部写 T[K] extends Date ? ...,检查对象是索引访问,不具有这项逐成员分配行为;Date | null 会整体检查失败。分配规则见条件类型的分配与整体检查及官方 Distributive Conditional Types。
类型保证与使用边界
WireOrder 只要求日期位置是 string,不保证它是有效时间、更不保证采用某种格式。真正从 Order 生成传输数据,需要运行时代码调用日期格式化方法;从网络读取时也需要验证输入。类型标注或断言不会完成这些工作。The Basics — Erased Types
这个工具有意只覆盖普通业务对象、可变数组、Date 和原始值;函数、Map、Set、只读数组、元组与循环引用需要另外设计。递归类型还会增加类型检查工作量,过深的输入可能触发编译器深度限制。只有多层模型确实共享稳定变换规则时,才值得引入;字段很少或转换规则各异,显式写传输类型通常更容易维护。TypeScript 4.1 的递归类型说明
从全景定位这项工具;若要复用方法参数和结果的配对,参见API 测试用例建模。
这一页,先记到这里。