JavaScript / TypeScript / 系统课时

内置工具类型

内置工具类型

本课解决“常见类型转换反复手写”的问题。你将掌握 Partial、Required、Pick、Omit 和 Record,并根据业务动作选择合适的工具类型。

学习目标

  • 区分五个常用工具类型的作用
  • 从领域模型派生新增、更新和展示类型
  • 避免工具类型组合造成语义模糊

五个常用工具

TypeScript 内置工具类型封装了常见的映射和条件类型转换,可直接复用。

工具类型 作用 常见场景
Partial 所有属性变为可选 局部更新
Required 所有属性变为必填 配置归一化
Pick 只保留指定属性 展示模型
Omit 排除指定属性 新增请求
Record 生成键值映射 字典和配置表

从一个模型派生多个用途

ts
// 仅开放允许更新的业务字段
interface User {
  id: number;
  name: string;
  email: string;
  active: boolean;
}

type UserPatch =
  Partial<Pick<User, "name" | "email" | "active">>;

type NewUser = Omit<User, "id">;

const roleLabels: Record<"admin" | "viewer", string> = {
  admin: "管理员",
  viewer: "访客",
};

function patchUser(user: User, patch: UserPatch): User {
  return { ...user, ...patch };
}

const created: NewUser = {
  name: "Ada",
  email: "ada@example.com",
  active: true,
};

const updated = patchUser(
  { id: 1, ...created },
  { active: false }
);

console.log(JSON.stringify(updated));
console.log(roleLabels.admin);

预期输出:

text
{"id":1,"name":"Ada","email":"ada@example.com","active":false}
管理员

UserPatch 只允许修改三个业务字段,避免把 id 也意外开放为更新项。NewUser 排除数据库生成的标识,Record 则保证每个角色都有对应文本。

Required 的典型用法

ts
interface Options {
  timeout?: number;
  retry?: number;
}

type NormalizedOptions = Required<Options>;

const options: NormalizedOptions = {
  timeout: 3000,
  retry: 2,
};

这是类型声明片段。归一化函数补齐默认值后,可以返回 NormalizedOptions,让后续代码不再处理 undefined。

选择原则

工具类型应围绕业务动作命名,而不是直接把复杂组合暴露给调用者。比如优先定义 UserPatch,而不是在每个函数参数中重复 Partial<Pick<User, "name" | "email" | "active">>。这样更容易维护,也能限制不应被修改的字段。

工具类型只转换声明

Partial、Required、Pick、Omit 和 Record 不会修改运行时对象。把 User 转成 Omit<User, "id"> 的类型不等于真的删除 id;发送 API 请求前仍要显式构造允许的字段,不能依赖类型防止敏感字段泄露。

Partial 只处理顶层属性,不会自动把嵌套对象的所有成员变成可选。Required 也不会替你生成默认值;options 的两个数值由代码实际提供。归一化函数应对缺失值设默认,并分别处理零、空值和非法输入,避免用逻辑或误把合法的零替换掉。

对象展开 patch 只是浅合并。若输入来自不可信 JSON,必须过滤允许字段并验证值类型;类型断言不会阻止运行时把 id 混入对象。可在编译期尝试给 UserPatch 写入 id 或把 active 写成字符串,确认失败,再运行正常更新验证输出与原用户是否符合不变性约定。

独立验证

使用 TypeScript 5.9.3 和 Node.js 22 检查本节。更新后的对象保留 id 和 email,只改变 active。给 UserPatch 临时写入 id 应失败;再对照 Required 片段,确认默认数值由代码提供,并非工具类型自动生成。把主示例保存为独立目录的 main.ts,执行 npx tsc main.ts --strict --target ES2022 --module commonjs --outDir dist,预期退出码为 0;再执行 node dist/main.js 核对上述结果。说明性片段按其上下文编译,练习目录保持 CommonJS 模块约定。

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

目录与阅读设置

阅读设置

17

记录一个想法

内置工具类型

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

登录哪都通