TypeScript Enumジェネレーター

文字列列挙型は、Color.Redが文字列REDに等しいように、各メンバーに文字列値を割り当てます。数値列挙型は、デフォルトで0から始まるインクリメントする数値を割り当てるため、Color.Redは0に、Color.Blueは1に等しくなります。文字列列挙型は、値がログやネットワークリクエストで読み取り可能であるため、デバッグに適しています。数値列挙型は、わずかにコンパクトで、逆引きマッピングをネイティブにサポートしているため、数値から名前を検索できます。ほとんどの最新のTypeScriptプロジェクトでは、明瞭さのために文字列列挙型が好まれます。

const enumはコンパイル時に完全にインライン化されます。TypeScriptコンパイラは、const enumメンバーへのすべての参照をそのリテラル値に置き換えるため、実行時に列挙型オブジェクトは存在しません。これにより、バンドルサイズが小さくなり、実行速度が向上します。ただし、const enumはイテレーションできません（Object.valuesがない）、逆引きマッピングをサポートせず、ライブラリコードの宣言ファイルで問題を引き起こす可能性があります。実行時のオーバーヘッドをゼロにしたい内部アプリケーション定数にはconst enumを使用してください。値のイテレーションが必要な場合やライブラリを公開する場合は、通常のenumを使用してください。

as constオブジェクトは、constアサーションを持つプレーンなJavaScriptオブジェクトを使用して、列挙型のような動作を実現します。例えば、const Color = { Red: 'RED', Blue: 'BLUE' } as const は、TypeScriptがリテラル型を推論するイミュータブルなオブジェクトを作成します。このアプローチはTypeScriptとJavaScriptの両方で機能し、enumよりもツリーシェイキングを良くサポートし、enumのトランスパイルにおけるいくつかのエッジケースを回避します。トレードオフは、型抽出がわずかに冗長になることです。ユニオン型を取得するには、type Color = typeof Color[keyof typeof Color]が必要です。多くのチームは、これらの実用的な理由から、enumよりもas constオブジェクトを好んでいます。

型ガードは、実行時に値の型を絞り込む関数です。列挙型の場合、型ガードは、文字列または数値が実際に列挙型の有効なメンバーであるかどうかをチェックし、その結果をTypeScriptの型システムに伝えます。例えば、function isColor(value: string): value is Color は、値が列挙型のメンバーと一致する場合にのみtrueを返します。これは、APIレスポンス、フォーム入力、または何らかの外部データを検証する際に役立ちます。これらのデータでは、型安全なコードで使用する前に、値が列挙型に属することを確認する必要があります。