实际开发中必备的 18 个 TypeScript 工具类型
本文由原文机器翻译。
正在加载文章...
正在加载文章...
本文由原文机器翻译。
TypeScript 工具类型常被介绍为“锦上添花”的辅助工具。 实际上,它们是 核心工具, 它们决定你的代码库能有多可扩展、安全和可维护。
在这篇文章中,基于一个关于 TypeScript 工具类型的精彩拆解视频,我将通过 具体、真实的示例 ——而不是抽象理论——来讲解最重要的几个。
随着应用增长,你会不断需要:
工具类型让你能够完成所有这些 而无需手动重写类型。
你有一个完整模型,但 API 或 UI 只需要其中一部分。
type User = {
id: string
email: string
password: string
createdAt: Date
}
type PublicUser = Pick<User, "id" | "email">
✅ 常见于:
你想要所有内容 除了 某些字段。
type SafeUser = Omit<User, "password">
这在以下场景中极其常见:
字段可选的 PATCH API。
type UpdateUserRequest = Partial<User>
而不是这样写:
type UpdateUserRequest = {
id?: string
email?: string
password?: string
createdAt?: Date
}
}你希望确保在某个阶段所有字段都存在。
type DraftUser = Partial<User>
type FinalUser = Required<DraftUser>
非常适合:
防止意外修改。
type ReadonlyUser = Readonly<User>
// ❌ Error
readonlyUser.email = "new@email.com"
广泛用于:
使用严格类型将键映射到值。
type Role = "admin" | "user" | "guest"
const permissions: Record<Role, string[]> = {
admin: ["read", "write", "delete"],
user: ["read", "write"],
guest: ["read"]
}
比 ... 安全得多 { [key: string]: any }.
操作联合类型。
type Status = "idle" | "loading" | "success" | "error"
type ActiveStatus = Exclude<Status, "idle">
type ErrorOrSuccess = Extract<Status, "error" | "success">
非常适合:
避免重复定义返回类型。
function getUser() {
return { id: "1", email: "test@test.com" }
}
type UserResponse = ReturnType<typeof getUser>
如果函数发生变化,类型会自动更新。
function login(email: string, password: string) {}
type LoginArgs = Parameters<typeof login>
// [string, string]
适用于:
class UserService {
constructor(private apiUrl: string) {}
}
type ServiceArgs = ConstructorParameters<typeof UserService>
// [string]
type ServiceInstance = InstanceType<typeof UserService>
在以下场景中非常有用:
type MaybeUser = User | null | undefined
type SafeUser = NonNullable<MaybeUser>
非常适合:
type Result = Awaited<Promise<User>>
在处理以下内容时必不可少:
type EventName = "user_created"
type Upper = Uppercase<EventName> // "USER_CREATED"
type Capital = Capitalize<EventName> // "User_created"
适用于:
了解这些工具类型并不在于死记硬背。 而在于 识别模式 并让 TypeScript 承担繁重的工作。
如果你每天都使用它们:
这是从 初级 到 高级 TypeScript 开发的最明显标志之一。
如果你想要一篇关于高级组合的后续文章(infer条件类型、真实 API schema),请告诉我。
返回