JavaScript / TypeScript / 系统课时
内置工具类型
内置工具类型
本课解决“常见类型转换反复手写”的问题。你将掌握 Partial、Required、Pick、Omit 和 Record,并根据业务动作选择合适的工具类型。
学习目标
- 区分五个常用工具类型的作用
- 从领域模型派生新增、更新和展示类型
- 避免工具类型组合造成语义模糊
五个常用工具
TypeScript 内置工具类型封装了常见的映射和条件类型转换,可直接复用。
| 工具类型 | 作用 | 常见场景 |
|---|---|---|
Partial |
所有属性变为可选 | 局部更新 |
Required |
所有属性变为必填 | 配置归一化 |
Pick |
只保留指定属性 | 展示模型 |
Omit |
排除指定属性 | 新增请求 |
Record |
生成键值映射 | 字典和配置表 |
从一个模型派生多个用途
// 仅开放允许更新的业务字段
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);预期输出:
{"id":1,"name":"Ada","email":"ada@example.com","active":false}
管理员UserPatch 只允许修改三个业务字段,避免把 id 也意外开放为更新项。NewUser 排除数据库生成的标识,Record 则保证每个角色都有对应文本。
Required 的典型用法
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 模块约定。