第32章 映射类型
案例 32:映射类型——让接口属性一键可选或只读
在业务开发中,常需要根据同一份数据模型派生出不同场景的变体:表单编辑时所有字段可选,展示时所有字段只读。手写重复接口费时且易错,TypeScript 的映射类型可优雅解决。
设计思路
借助内置工具类型 Partial<T> 和 Readonly<T>,它们本质是通过索引签名遍历属性并附加修饰符。为加深理解,我们手动实现这两个工具,并组合出“可选+只读”的最终形态。
核心代码
// 原始接口
interface User {
name: string;
age: number;
email: string;
}
// 手动实现 Partial(所有属性可选)
type MyPartial<T> = { [K in keyof T]?: T[K] };
// 手动实现 Readonly(所有属性只读)
type MyReadonly<T> = { readonly [K in keyof T]: T[K] };
// 组合:可选 + 只读
type OptionalReadonly<T> = { readonly [K in keyof T]?: T[K] };
// 应用
type OptionalUser = MyPartial<User>;
type ReadonlyUser = MyReadonly<User>;
type BothUser = OptionalReadonly<User>;
// 验证
const u1: OptionalUser = { name: "张三" }; // 只给部分属性
const u2: ReadonlyUser = { name: "李四", age: 30, email: "a@b.com" };
// u2.name = "王五"; // 编译错误:只读
const u3: BothUser = { age: 25 }; // 完全自由
console.log(u1, u2, u3);
运行结果
编译无错误,控制台输出三个对象。若取消注释 u2.name = ...,TypeScript 会立即报错,验证只读约束生效。
成功要点
掌握了 keyof T 遍历对象键、? 和 readonly 修饰符在映射类型中的放置位置,就理解了 TypeScript 工具类型的核心原理。
测试建议
尝试修改 MyPartial 的键为 readonly 前缀,观察既有可选又有只读的效果;或对嵌套对象使用 DeepPartial 递归映射。
注意事项
映射类型不会对原始接口产生副作用,返回的是新类型。但注意 readonly 只限制编译期赋值,运行时对象仍可变。
运行验证
使用 npx tsc mapping.ts && node mapping.js 执行,无报错且输出三个对象即为成功。