TypeScriptの列挙型（enum）の使い方とUnion型との使い分け：保守性の高いコードを書くための手法解説

2026年5月18日

配列・タプル・Enum

TypeScriptは、2026年現在においても進化を続けており、型安全性を高めるための機能が豊富に提供されています。

中でも列挙型（enum）は、関連する定数を一つにまとめる強力な手段として、古くから多くのプロジェクトで利用されてきました。

しかし、プロジェクトの規模が拡大し、より高度な型推論やパフォーマンスが求められる中で、enumの取り扱いには注意が必要な場面も増えています。

本記事では、TypeScriptにおけるenumの基本的な使い方から、近年主流となっているUnion型との使い分け、そして保守性の高いコードを書くためのベストプラクティスを詳しく解説します。

目次 [ close ]

TypeScriptにおける列挙型（enum）の基本構造

TypeScriptの列挙型（enum）は、名前付き定数の集合を定義するための構文です。

JavaScriptには標準で列挙型が存在しないため、TypeScriptが独自に導入した言語機能の一つです。

enumを使用することで、マジックナンバーや生の文字列を直接記述することを避け、コードの可読性と保守性を向上させることができます。

列挙型には大きく分けて、数値列挙型（Numeric enums）と文字列列挙型（String enums）の2種類が存在します。

数値列挙型（Numeric enums）の仕組み

数値列挙型は、メンバーに数値が割り当てられる最も基本的な形態です。

デフォルトでは、最初のメンバーに0が割り当てられ、以降のメンバーには連番で数値が自動的に付与されます。

特定のメンバーに数値を明示的に割り当てることも可能であり、その場合は後続のメンバーがその数値からインクリメントされます。

以下に、数値列挙型の基本的な定義例を示します。

TypeScript

enum TaskStatus {
  Todo,      // 0
  InProgress, // 1
  Done,       // 2
}

const currentStatus: TaskStatus = TaskStatus.InProgress;
console.log(currentStatus);

実行結果

数値列挙型の最大の特徴は、「逆引き（Reverse Mapping）」が可能であることです。

これは、値からメンバー名を取得できる仕組みであり、デバッグ時などに非常に便利です。

TypeScript

console.log(TaskStatus[1]); // "InProgress" が出力される

ただし、逆引きは数値列挙型のみの機能であり、文字列列挙型では利用できない点に注意が必要です。

文字列列挙型（String enums）の利点

文字列列挙型は、各メンバーに対して文字列リテラルを明示的に割り当てる形式です。

数値列挙型とは異なり、自動インクリメントの機能はありませんが、実行時の値が意味を持つため、ログ出力やAPI連携において非常に有用です。

文字列列挙型を使用することで、プログラムの実行時に何が起きているかを把握しやすくなります。

TypeScript

enum OrderDirection {
  Ascending = "ASC",
  Descending = "DESC",
}

function setSortOrder(direction: OrderDirection) {
  console.log(`Sorting direction is: ${direction}`);
}

setSortOrder(OrderDirection.Ascending);

実行結果

Sorting direction is: ASC

このように、値そのものが意味を持つため、外部システムとのデータ送受信において型の不一致を防ぐ効果があります。

enumを使用する際のリスクと注意点

enumは便利な機能ですが、TypeScript独自の仕様に起因するいくつかのデメリットが存在します。

これらを理解せずに多用すると、意図しないバグやビルド後のファイルサイズの増大を招く可能性があります。

トランスパイル後のコード増大

TypeScriptの多くの機能は、JavaScriptに変換される際に消去されますが、enumは「実体を持つオブジェクト」としてJavaScriptコードに変換されます。

特に通常のenum（非const enum）は、即時実行関数（IIFE）として出力されるため、ツリーシェイキング（不要なコードの削除）が効きにくいという性質があります。

TypeScript

// TypeScript
enum UserRole {
  Admin,
  User
}

JavaScript

// トランスパイル後のJavaScript
var UserRole;
(function (UserRole) {
    UserRole[UserRole["Admin"] = 0] = "Admin";
    UserRole[UserRole["User"] = 1] = "User";
})(UserRole || (UserRole = {}));

このように複雑なオブジェクトが生成されるため、モダンなバンドラーによる最適化が困難になるケースがあります。

数値列挙型の型安全性の欠如

数値列挙型には、歴史的な経緯から定義されていない数値代入を許容してしまうという脆弱性があります。

例えば、TaskStatusというenumに0, 1, 2しか定義されていない場合でも、100という数値を代入できてしまうことがあります（TypeScriptのバージョンや設定によりますが、互換性のために残っている挙動です）。

このため、厳密な型安全性を求めるプロジェクトでは、数値列挙型の使用を避ける傾向にあります。

Union型とconstアサーションによる代替手法

2026年現在のフロントエンド開発において、enumに代わる手法として最も推奨されているのが、Union型とconstアサーションの組み合わせです。

この手法は、TypeScriptの柔軟性を最大限に活かしつつ、enumの欠点を補うことができます。

constアサーション（as const）の使い方

as constを使用すると、オブジェクトのプロパティを読み取り専用のリテラル型として扱うことができます。

これにより、JavaScriptの標準的なオブジェクトを利用しながら、enumに近い型安全性を確保できます。

TypeScript

const COLORS = {
  Red: "red",
  Blue: "blue",
  Green: "green",
} as const;

// 型の抽出
type Color = typeof COLORS[keyof typeof COLORS];

function paint(color: Color) {
  console.log(`Painting with ${color}`);
}

paint(COLORS.Red); // OK
// paint("yellow"); // Error: Argument of type '"yellow"' is not assignable to parameter of type 'Color'.

この方法の利点は、「実行時に生成されるコードが単純なオブジェクトのみである」ことです。

また、Union型は構造的部分型（Structural Typing）に基づいているため、値そのものが一致していれば代入可能であり、enumのような公称的部分型（Nominal Typing）の制約に縛られません。

Union型とenumの比較表

それぞれの特徴を整理すると、以下のようになります。

機能・特徴	enum (列挙型)	Union型 (as const)
トランスパイル後の形状	IIFE（即時実行関数）	プレーンなオブジェクト
ツリーシェイキング	苦手	得意
型安全性（数値）	一部脆弱性あり	非常に高い
逆引き（数値のみ）	可能	不可（手動実装が必要）
開発体験（DX）	IDE補完が強力	IDE補完が非常に強力

保守性の高いコードを書くための使い分け基準

どちらの手法が絶対的に優れているというわけではなく、コンテキストに応じた使い分けが重要です。

保守性を高めるためには、チーム内で明確なルールを設けることが推奨されます。

enumを採用すべきケース

既存のコードベースがenumを中心に構築されている場合や、バックエンドの言語（C#やJavaなど）との親和性を重視する場合は、enumを選択するのが合理的です。

また、「値」そのものではなく「名前」によってロジックを管理したい場合は、enumが適しています。

ただし、その際も可能な限りconst enumの使用を検討してください。

const enumは、ビルド時に値がインライン展開されるため、実行時のオーバーヘッドを削減できます。

TypeScript

const enum AppConfig {
  MaxRetries = 3,
  Timeout = 5000,
}

Union型を採用すべきケース

新規プロジェクトの立ち上げや、React、Next.jsなどを用いたモダンなフロントエンド開発では、Union型とconstアサーションの組み合わせが第一選択肢となります。

特にAPIから受け取る文字列が特定のパターンに限られている場合、Union型を定義するだけで、型ガードやパターンマッチングが非常にスムーズに行えます。

また、「特定のライブラリに依存しない純粋なJavaScriptに近いコードを保ちたい」という設計思想がある場合も、こちらが有利です。

実践：リファクタリングで保守性を向上させる

多くの現場では、歴史的に積み上がったenumが保守の妨げになっているケースが見受けられます。

そのような場合、どのようにUnion型へ移行し、保守性を高めるべきかを具体的なコードで解説します。

ステップ1：enumをオブジェクト定数に置き換える

まずは、以下のような古いenum定義を見直します。

TypeScript

// Before: 列挙型
enum UserType {
  Guest = "GUEST",
  Member = "MEMBER",
  Premium = "PREMIUM",
}

これを、as constを用いたオブジェクトに変換します。

TypeScript

// After: constアサーション
const USER_TYPES = {
  GUEST: "GUEST",
  MEMBER: "MEMBER",
  PREMIUM: "PREMIUM",
} as const;

ステップ2：型を抽出して利用する

次に、このオブジェクトから型を抽出します。

これにより、手動でUnion型を定義する手間が省け、定数と型の同期が自動で行われます。

TypeScript

type UserType = typeof USER_TYPES[keyof typeof USER_TYPES];

function checkAccess(userType: UserType) {
  if (userType === USER_TYPES.PREMIUM) {
    // プレミアム特典の処理
  }
}

このようにリファクタリングすることで、ランタイムのコードが軽量化され、型のメンテナンス性も格段に向上します。

将来を見据えた型定義の考え方

2026年のTypeScriptエコシステムでは、型のメタプログラミングが以前よりも進化しています。

列挙型を単なる値のリストとして捉えるのではなく、ドメイン知識をコードに落とし込むための「仕様」として定義することが重要です。

保守性の高いコードとは、「変更に対して開かれており、かつ壊れにくい」コードを指します。

enumやUnion型を定義する際には、将来的にその値が増える可能性があるか、外部システムとの結合度はどの程度かを常に自問自答する必要があります。

大規模開発でのパターン：Namespaceの活用

名前の衝突を避けつつ、関連する定数や型を整理するために、Namespaceを活用する手法も有効です。

これにより、モジュール性が高まり、大規模なプロジェクトでも迷わずに必要な定義にアクセスできます。

TypeScript

export namespace Auth {
  export const ROLES = {
    Admin: "admin",
    Editor: "editor",
    Viewer: "viewer",
  } as const;

  export type Role = typeof ROLES[keyof typeof ROLES];
}

// 利用側
const currentRole: Auth.Role = Auth.ROLES.Admin;

このパターンは、enumの「名前空間としての利便性」とUnion型の「柔軟性・効率性」を両立させた、2026年現在非常に評価の高い設計パターンの一つです。