JavaScript / TypeScript / 系统课时
使用内置工具类型
使用内置工具类型
同一份业务结构常常需要“全部可选”“只保留部分字段”或“排除某个成员”等变体。TypeScript 的内置工具类型可以直接转换现有类型,减少重复声明,并让变体始终跟随源类型更新。
学习目标
- 掌握常用工具类型的输入与结果
- 根据修改、展示、映射和函数返回值场景选择工具类型
- 避免把工具类型用于不符合业务约束的结构
工具类型解决什么问题
Partial<T> 把属性变为可选,Required<T> 把属性变为必选;Pick<T, K> 保留指定键,Omit<T, K> 排除指定键;Record<K, V> 根据键联合构造映射;Exclude<U, M> 从联合中移除成员;ReturnType<F> 提取函数返回类型。
这些工具只改变静态类型,不会在运行时补字段、删除属性或校验数据。运行时输入仍需由程序逻辑或校验库处理。
主示例:从用户类型派生多个变体
下面以一个用户模型为源类型,派生更新参数、公开视图、创建参数、角色映射和函数返回值。每个类型都来自已有声明,因此源字段变化时,相关变体会同步参与类型检查。
type Role = "admin" | "editor" | "guest";
interface User {
id: number;
name: string;
email: string;
role: Role;
}
interface UserDraft {
name?: string;
role?: Role;
}
type UserPatch = Partial<User>;
type CompleteDraft = Required<UserDraft>;
type PublicUser = Pick<User, "id" | "name">;
type CreateUserInput = Omit<User, "id">;
type RoleLabels = Record<Role, string>;
type StaffRole = Exclude<Role, "guest">;
function formatUser(user: PublicUser) {
return `${user.id}:${user.name}`;
}
type FormattedUser = ReturnType<typeof formatUser>;
const patch: UserPatch = { email: "new@example.com" };
const draft: CompleteDraft = { name: "Ada", role: "editor" };
const input: CreateUserInput = {
name: "Ada",
email: "ada@example.com",
role: "admin",
};
const labels: RoleLabels = {
admin: "管理员",
editor: "编辑",
guest: "访客",
};
const staff: StaffRole = "editor";
const formatted: FormattedUser = formatUser({ id: 1, name: draft.name });
console.log(patch.email);
console.log(input.role);
console.log(labels[staff]);
console.log(formatted);预期输出:
new@example.com
admin
编辑
1:AdaRecord<Role, string> 要求三个角色键全部存在;少写或拼错任意一个键都会产生编译错误。ReturnType 在函数返回结构变化时会自动更新,适合避免手写重复的返回类型。
选择原则与边界
更新接口通常使用 Partial<T>,但它会把所有字段都变为可选,也可能放开本不允许修改的 id。更稳妥的写法是先用 Pick 或 Omit 限定字段,再套用 Partial,例如 Partial<Pick<User, "name" | "email">>。
Required<T> 只移除属性上的可选标记,不会排除值类型中的 undefined。Omit 和 Pick 适合对象属性,Exclude 适合联合成员,二者不要混用。
工具类型可以嵌套,但层级过深会降低可读性。业务规则明确时,应为组合结果命名,并优先让名称表达用途,而不是把复杂转换直接写在每个参数位置。
本课总结
- 内置工具类型通过转换源类型减少重复声明
Pick、Omit与Partial常组合用于限制可修改字段- 工具类型只约束编译期结构,运行时数据仍需单独校验
下一课预告
下一课将继续学习条件类型,把“根据输入类型选择不同结果”的规则写入类型系统,并为更复杂的类型推导打基础。