JavaScript / TypeScript / 系统课时
映射类型
映射类型
当一个对象类型已经有稳定的属性集合,而你只想统一改变这些属性的可选性、只读性或值类型时,映射类型可以避免重复声明。它会遍历已有键集合,再按同一规则生成新类型,同时保留属性之间的对应关系。
学习目标
- 理解
[K in keyof T]如何遍历对象类型的属性键 - 使用
?、-?、readonly、-readonly批量修改属性修饰符 - 区分“保留原值类型”和“统一替换值类型”两类映射方式
映射类型的核心规则
映射类型最常见的骨架是 type Copy<T> = { [K in keyof T]: T[K] }。其中 keyof T 先得到 T 的全部属性键联合类型,K in ... 再逐个遍历这些键,最后用 T[K] 取回当前属性原本的值类型。
这里发生的都是类型层面的转换,不会在 JavaScript 运行时创建新对象。它适合“键集合来自已有类型,但每个键都执行同一条类型规则”的场景。
批量修改属性
下面把一个只读的领域对象转换成表单草稿:所有字段都变为可选,同时移除只读限制,并把字段值统一改为字符串。
ts
type User = {
readonly id: number;
name: string;
age: number;
};
// 移除 readonly、添加可选标记,并把表单值统一为 string
type FormState<T> = {
-readonly [K in keyof T]?: string;
};
const form: FormState<User> = {
id: "2",
name: "Ada",
};
// id 已经不是 readonly,age 也因为 ? 可以暂时缺省
form.id = "3";
console.log(form.id, form.name, form.age ?? "未设置");预期输出
text
3 Ada 未设置如果希望保留每个属性原来的值类型,把 string 换成 T[K] 即可。也就是说,映射类型既能修改“属性修饰符”,也能修改“属性值类型”,两者可以独立组合。
修饰符的加减法
readonly 和 ? 默认表示“添加修饰符”,在前面加 - 则表示“移除修饰符”。例如 type MutableRequired<T> = { -readonly [K in keyof T]-?: T[K] } 会同时移除只读和可选标记。
| 写法 | 作用 |
|---|---|
readonly [K in keyof T] |
批量添加只读 |
-readonly [K in keyof T] |
批量移除只读 |
[K in keyof T]? |
批量变为可选 |
[K in keyof T]-? |
批量变为必选 |
TypeScript 内置的 Partial<T>、Required<T> 和 Readonly<T> 都建立在这类机制之上。实际建模时,优先复用这些内置工具类型;只有规则更具体,例如统一改值类型或同时调整多个修饰符时,再定义自己的映射类型。
按自己的节奏,确认真正理解。