上級

数値enumはObject.keys()で要素数が2倍になる（逆引きマッピングの副作用）

数値enumは、コンパイル後のJavaScriptオブジェクトに「メンバー名→値」だけでなく「値→メンバー名」の逆引きも自動的に持たせます。この副作用でObject.keys()を呼ぶと、メンバーの2倍の数のキーが返ってきます。

なぜエラーが出ないのか

出力: 4

（エラーなし）

TypeScriptは何も報告しません。型検査も構文も正しいためです

出力: 4

実際の挙動 — 期待した結果と食い違っている箇所

見つけ方

エラーが出ないので、出力を目で確かめるか、コードを目で追うしかありません。この種の誤りが最も発見が遅れます

このエラーが出る典型パターン

 1  enum Status {
 2    Active,
 3    Inactive,
 4  }
 5  console.log(Object.keys(Status).length                                     );
                                                         ^

 1  enum Level {
 2    Low,
 3    Mid,
 4    High,
 5  }
 6  console.log(Object.keys(Level).length                                     );
                                                        ^

 1  enum Direction {
 2    North,
 3    South,
 4    East,
 5    West,
 6  }
 7  console.log(Object.keys(Direction).length                                     );
                                                            ^

 1  enum Weekday {
 2    Mon,
 3    Tue,
 4    Wed,
 5    Thu,
 6    Fri,
 7  }
 8  console.log(Object.keys(Weekday).length                                     );
                                                          ^

 1  enum Suit {
 2    Clubs,
 3    Diamonds,
 4    Hearts,
 5    Spades,
 6  }
 7  console.log(Object.keys(Suit).length                                     );
                                                       ^

よくある誤解

「enumはただのメンバー一覧を表す型のはず」という理解は、コンパイル後の実体までは説明していません。数値enumはコンパイル時にJavaScriptの通常のオブジェクトへ変換され、逆引き用のキーも一緒に埋め込まれます。

実務での勘所

実際にコンパイルすると、enum Color { Red, Green }は{ 0: "Red", 1: "Green", Red: 0, Green: 1 }というオブジェクトになります。名前から値を引く通常の使い方だけでなく、値から名前を引きたい場面(ログ出力でColor[0]から"Red"を得るなど)のために、TypeScriptが両方向の対応を1つのオブジェクトに詰め込んでいます。この副作用を避けたい場合は、文字列enumを使うと、逆引き用のエントリは生成されずObject.keys()も本来の要素数どおりになります。

演習をはじめる

関連するエラー

• 文字列リテラルをenum型の引数に渡すとエラーになる理由enumで定義した型は、見た目が近い文字列リテラルであっても別の型として扱われます。
• is not assignable to type の原因と直し方変数への代入・関数の戻り値・プロパティへの代入など、宣言した型と違う型の値を渡そうとしたときにtscが検出するエラーです。