JavaScript / TypeScript / 系统课时
编写映射类型
编写映射类型
映射类型通过遍历已有类型的键,批量生成结构一致但规则不同的新类型。它适合统一添加只读或可选标记、移除修饰符,以及按条件保留或重命名属性。
学习目标
- 使用
[K in keyof T]遍历对象键名 - 批量增加或移除
readonly、?修饰符 - 使用键重映射按条件筛选属性
映射类型的核心结构
映射类型由键集合、遍历变量和属性值三部分组成。keyof T 产生键名联合,K in keyof T 逐个遍历,T[K] 读取对应属性类型。基本形式是 { [K in keyof T]: T[K] }。
默认映射会保留原属性的只读和可选状态。若要显式修改修饰符,可以在 readonly 或 ? 前使用 + 或 -;省略 + 时默认为添加。
批量修改属性修饰符
下面的完整示例同时演示添加修饰符、移除修饰符和键重映射。映射类型只改变编译期类型,不会在运行时自动冻结、复制或删除对象属性。
interface Account {
readonly id: number;
name?: string;
active: boolean;
}
type LockedPartial<T> = {
readonly [K in keyof T]?: T[K];
};
type MutableRequired<T> = {
-readonly [K in keyof T]-?: T[K];
};
type StringProperties<T> = {
[K in keyof T as T[K] extends string | undefined ? K : never]: T[K];
};
const locked: LockedPartial<Account> = {
id: 1
};
const editable: MutableRequired<Account> = {
id: 1,
name: "Ada",
active: true
};
// 已移除 readonly,因此可以重新赋值
editable.id = 2;
const labels: StringProperties<Account> = {
name: "Administrator"
};
console.log(locked.id, editable.id, editable.name, labels.name);预期输出
1 2 Ada AdministratorLockedPartial<Account> 把所有属性变为只读且可选;MutableRequired<Account> 使用 -readonly 和 -? 恢复可写、必填;StringProperties<Account> 通过 as 将不符合条件的键重映射为 never,从结果中移除。
组合方式与边界
映射类型经常与条件类型配合:条件负责判断属性值类型,映射负责遍历键。内置工具类型 Partial<T>、Required<T>、Readonly<T> 和 Pick<T, K> 都建立在类似机制上。
需要重命名键时,可以在 as 后使用模板字面量类型,例如把 name 转换为 getName。不过键重映射只改变类型层面的属性名,运行时仍需代码真正创建对应字段。
不要把映射类型理解为对象转换函数。它不会生成新对象,也不会执行数据清洗。默认映射还会保留原修饰符,因此要恢复必填或可写状态,必须明确写出 -? 或 -readonly。
当属性包含 undefined 时,筛选条件要结合项目的严格空值设置判断。开启 strictNullChecks 后,string 与 string | undefined 的匹配结果不同。
本课总结
[K in keyof T]可以逐个遍历对象键并读取T[K]readonly、?及其负号形式可批量调整属性修饰符- 键重映射
as能重命名或通过never过滤属性
下一课预告
下一课将继续组合条件类型与映射类型,编写更贴近业务规则的可复用类型工具。