JavaScript / TypeScript / 系统课时

编写映射类型

编写映射类型

映射类型通过遍历已有类型的键,批量生成结构一致但规则不同的新类型。它适合统一添加只读或可选标记、移除修饰符,以及按条件保留或重命名属性。

学习目标

  • 使用 [K in keyof T] 遍历对象键名
  • 批量增加或移除 readonly、? 修饰符
  • 使用键重映射按条件筛选属性

映射类型的核心结构

映射类型由键集合、遍历变量和属性值三部分组成。keyof T 产生键名联合,K in keyof T 逐个遍历,T[K] 读取对应属性类型。基本形式是 { [K in keyof T]: T[K] }。

默认映射会保留原属性的只读和可选状态。若要显式修改修饰符,可以在 readonly 或 ? 前使用 + 或 -;省略 + 时默认为添加。

批量修改属性修饰符

下面的完整示例同时演示添加修饰符、移除修饰符和键重映射。映射类型只改变编译期类型,不会在运行时自动冻结、复制或删除对象属性。

ts
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);

预期输出

text
1 2 Ada Administrator

LockedPartial<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 过滤属性

下一课预告

下一课将继续组合条件类型与映射类型,编写更贴近业务规则的可复用类型工具。

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

目录与阅读设置

阅读设置

17

记录一个想法

编写映射类型

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

登录哪都通