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> 都建立在这类机制之上。实际建模时,优先复用这些内置工具类型;只有规则更具体,例如统一改值类型或同时调整多个修饰符时,再定义自己的映射类型。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

映射类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通