実務開発で必須のTypeScriptユーティリティ型18選
この記事は原文から機械翻訳されています。
記事を読み込み中...
記事を読み込み中...
この記事は原文から機械翻訳されています。
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開発において ジュニア から シニア へ移行する最も明確な兆候の1つです。
高度な組み合わせ(infer、条件型、実際のAPIスキーマ)を含む続編記事をご希望の場合は、お知らせください。
戻る