C# 出身者のための TypeScript ユーティリティ型（Partial / Pick / Omit / Record）

みなさんこんにちは！ヒロポンです！！

「来週から TypeScript の案件、ちょっと入ってもらうかも」

C# を長くやってると、こういう話がある日ふっと降ってくる。で、腹をくくって触ってみると、文法はだいたい読めるんですよね。

読める。読めるんだけど、Partial<User> とか Pick<User, "id"> みたいな 型から型を作る やつ。あれを見た瞬間、「え、これ C# のどれに当たるん？？」って手が止まる。

理由はシンプルで、C# にはそのものズバリの言語機能が無いからなんです。だから既知の引き出しに紐づかない。紐づかないから、必要以上に身構えてしまう。

今日は、C# 出身者向けに TypeScript ユーティリティ型（Partial / Pick / Omit / Record）を、「C# でいうアレ」に対応づけて整理します。ゴールは、TypeScript ユーティリティ型を C# の感覚のまま読めるようにすること。それだけです。

💡 型そのものの違い（構造的型付け）は TypeScript の interface と C# の interface は別物 にまとめてあります。本シリーズと同じ「C# 出身者の橋渡し」目線で並べているので、合わせて読むと入りやすいはず。

C# だと「既存の型から一部だけ使う型」を作るのが地味に面倒

C# で「User クラスの一部のプロパティだけ持つ型」が欲しくなったこと、ありますよね。更新用に一部だけ。一覧表示用に id と name だけ。そういうやつ。

C# だと専用のクラス（DTO）を別に定義するか、リフレクションでこねるか、の二択になる。

俺も昔、更新用・一覧用・詳細用で似たようなクラスを3つ手書きして、プロパティを1個足すたびに3箇所直す羽目になったことがあります。あれ、地味にだるいんですよね。

TypeScript は、この「既存の型から新しい型を組み立てる」を 型レベルの1行 で片づける。それがユーティリティ型です。

対応マップ: C# のやり方 ↔ TS ユーティリティ型

先に全体像から。C# で手書きしてたやつが、TS だとどのユーティリティ型に化けるか。対応で並べます。

ここから、この共通の型をベースに1個ずつ見ていきます。まずは土台になる User 型。

interface User {
  id: number;
  name: string;
  email: string;
  role: "admin" | "member";
}

対応1: Partial — 全プロパティを任意にする

Partial<User> は、User の全プロパティを「任意（? 付き）」にした型を返す。C# でいうと、更新用に全プロパティを nullable にした別クラスを手書きするやつ。あれが1行で済みます。

// Partial<User> = { id?: number; name?: string; email?: string; role?: "admin" | "member" }
type UserPatch = Partial<User>;

function updateUser(id: number, patch: UserPatch): void {
  // 一部だけ渡せるので、更新処理にちょうどいい
  console.log(`update ${id}:`, patch);
}

updateUser(1, { name: "佐藤" });            // name だけ更新
updateUser(1, { email: "sato@example.com" }); // email だけ更新

updateUser に「変えたいプロパティだけ」を渡せる。こんな感じで、部分更新の引数型としてバチッとハマります。地味だけど効くやつです！！ただ、この「全部が任意」という性質。後でしっかり刺さってくるので、頭の隅に置いといてください。

対応2: Pick<T, K> — 必要なプロパティだけ抜く

Pick<User, "id" | "name"> は、User から id と name だけ を抜き出した型。一覧表示用の DTO を別に書いてたやつが、これに置き換わります。

// 一覧表示に必要な id と name だけ
type UserSummary = Pick<User, "id" | "name">;

const summary: UserSummary = { id: 1, name: "佐藤" };
// email や role を足すと「その型に存在しない」でコンパイルエラーになる

うれしいのは、元の User に項目が増えても UserSummary は id と name のままな点。C# で DTO を手書きしてると元クラスに引きずられて直し忘れが出るんだけど、Pick は「明示した分だけ」なのでズレない。

対応3: Omit<T, K> — いらないプロパティを除く

Omit は Pick の逆で、「これ以外ぜんぶ」を作ります。Omit<User, "id"> なら、id を除いた残り全部。

// 新規作成時は id をまだ持っていない → id を除いた型
type NewUser = Omit<User, "id">;

const draft: NewUser = {
  name: "鈴木",
  email: "suzuki@example.com",
  role: "member",
};
// draft に id を書くと「存在しない」でエラー。逆に name を抜くと「必須が足りない」でエラー

使い分けはシンプルで、「除きたいものが少ないなら Omit、残したいものが少ないなら Pick」。これで読みやすくなります。どっちも元の型に自動で追従してくれる。

対応4: Record<K, V> — キーと値の型付き辞書

Record<K, V> は、キーの型 K と値の型 V を指定した辞書型。C# の Dictionary<K, V> に近いんだけど、キーを網羅チェックしてくれる のが強い。

// ロールごとの表示ラベルを、キー漏れなく定義する
type RoleLabel = Record<User["role"], string>;

const labels: RoleLabel = {
  admin: "管理者",
  member: "メンバー",
};
// "admin" か "member" のどちらかを書き忘れると「不足してる」でエラーになる