TypeScriptでenumを避ける理由｜union型・as constの使い方

こんにちは！今回はTypeScriptのenumが非推奨になった理由と、代わりの書き方について詳しく解説していきます。

enumが非推奨になった理由
代わりの書き方
実際の使用例
移行のタイミング
まとめ
開発・プログラミング記事をまとめて読む
TypeScriptの避けたい書き方関連記事

enumが非推奨になった理由

enumは便利な機能に見えますが、いくつかの問題点があります：

バンドルサイズが大きくなる
型安全性が完全ではない
Tree-shakingが効きにくい

特にバンドルサイズの問題は深刻です。例えば以下のようなenumを見てみましょう：

enum Direction {
    Up = "UP",
    Down = "DOWN",
    Left = "LEFT",
    Right = "RIGHT"
}

このコードはJavaScriptに変換すると、こんな感じになります：

var Direction;
(function (Direction) {
    Direction["Up"] = "UP";
    Direction["Down"] = "DOWN";
    Direction["Left"] = "LEFT";
    Direction["Right"] = "RIGHT";
})(Direction || (Direction = {}));

かなり冗長なコードになってしまいますよね。

代わりの書き方

1. constアサーションを使用する

const Direction = {
    Up: 'UP',
    Down: 'DOWN',
    Left: 'LEFT',
    Right: 'RIGHT'
} as const;

type Direction = typeof Direction[keyof typeof Direction];

これなら型安全性も保てて、バンドルサイズも小さくなります。

2. Union型を使用する

type Direction = 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';

シンプルで分かりやすいですね。値の種類が少ない場合はこちらがおすすめです。

3. オブジェクトと型の組み合わせ

const DirectionValue = {
    Up: 'UP',
    Down: 'DOWN',
    Left: 'LEFT',
    Right: 'RIGHT'
} as const;

type Direction = typeof DirectionValue;

この方法だと、値と型の両方を扱えて便利です。

実際の使用例

新しい書き方を使った実践的な例を見てみましょう：

// 従来のenum
enum UserRole {
    Admin = 'ADMIN',
    User = 'USER',
    Guest = 'GUEST'
}

// 新しい書き方
const Roles = {
    Admin: 'ADMIN',
    User: 'USER',
    Guest: 'GUEST'
} as const;

type Role = typeof Roles[keyof typeof Roles];

// 使用例
function hasPermission(role: Role): boolean {
    return role === Roles.Admin;
}

移行のタイミング

すでにenumを使っているプロジェクトがある場合は、以下のタイミングで移行することをおすすめします：

新規機能の追加時
リファクタリング時
パフォーマンス改善時

一度に全てを書き換える必要はありません。少しずつ移行していけば大丈夫です。

まとめ

enumは便利な機能でしたが、より良い代替手段が出てきました。特に as const とUnion型の組み合わせは、型安全性とバンドルサイズの両方を改善できる優れた方法です。

これから新しくTypeScriptのプロジェクトを始める場合は、enumの代わりにここで紹介した方法を使ってみてください。より良いコードが書けるはずです。

TypeScriptのモダンな型設計を学んだあとにAI活用や副業学習まで広げる場合は、有料講座を選ぶ前に、自分にスクールが必要な段階かも確認しておくと判断しやすくなります。AIスクールをおすすめしない人では、目的・作業時間・成果物の準備が整っているかを整理しています。

enumを避けてUnion型やas constを使うような型設計を学んだあと、AI活用や副業学習で有料支援を検討する場合は、AIスクールの無料相談は何社受けるべき？も確認してください。1社だけで決めず、質問対応、作れる成果物、学習の進め方、料金総額、返金条件を同じ質問で比べると、モダンな型設計の学習からどこまで支援が必要か判断しやすくなります。