TypeScript Enum Generator

String-Enums weisen jedem Mitglied Zeichenfolgenwerte zu, z. B. Color.Red entspricht dem String RED. Numerische Enums weisen standardmäßig inkrementierende Zahlen ab 0 zu, sodass Color.Red 0 und Color.Blue 1 entspricht. String-Enums sind besser für das Debugging geeignet, da die Werte in Protokollen und Netzwerkanfragen lesbar sind. Numerische Enums sind etwas kompakter und unterstützen nativ Reverse-Mappings, sodass Sie den Namen anhand der Zahl nachschlagen können. Die meisten modernen TypeScript-Projekte bevorzugen String-Enums zur besseren Lesbarkeit.

Konst-Enums werden zur Kompilierzeit vollständig inline gesetzt. Der TypeScript-Compiler ersetzt jede Referenz auf ein Konst-Enum-Mitglied durch seinen Literalwert, sodass zur Laufzeit kein Enum-Objekt existiert. Dies führt zu kleineren Bundle-Größen und schnellerer Ausführung. Konst-Enums können jedoch nicht iteriert werden (keine Object.values), unterstützen kein Reverse-Mapping und können Probleme mit Deklarationsdateien in Bibliotheks-Code verursachen. Verwenden Sie Konst-Enums für interne Anwendungskonstanten, bei denen Sie keine Laufzeit-Overhead wünschen. Verwenden Sie reguläre Enums, wenn Sie über Werte iterieren müssen oder wenn Sie eine Bibliothek veröffentlichen.

Ein as const Objekt verwendet ein einfaches JavaScript-Objekt mit einer const-Assertion, um ein Enum-ähnliches Verhalten zu erzielen. Zum Beispiel erstellt const Color = { Red: 'RED', Blue: 'BLUE' } as const ein unveränderliches Objekt, bei dem TypeScript die Literal-Typen ableitet. Dieser Ansatz funktioniert sowohl in TypeScript als auch in JavaScript, unterstützt Tree-Shaking besser als Enums und vermeidet einige Randfälle bei der Enum-Transpilierung. Der Nachteil ist eine etwas ausführlichere Typ-Extraktion: Sie benötigen type Color = typeof Color[keyof typeof Color], um den Union-Typ zu erhalten. Viele Teams bevorzugen aus diesen praktischen Gründen inzwischen as const Objekte gegenüber Enums.

Ein Typ-Guard ist eine Funktion, die den Typ eines Wertes zur Laufzeit verengt. Für ein Enum prüft ein Typ-Guard, ob eine Zeichenfolge oder eine Zahl tatsächlich ein gültiges Mitglied des Enums ist, und teilt dem TypeScript-Typsystem das Ergebnis mit. Beispielsweise gibt function isColor(value: string): value is Color nur dann true zurück, wenn der Wert mit einem Enum-Mitglied übereinstimmt. Dies ist nützlich bei der Validierung von API-Antworten, Formulareingaben oder beliebigen externen Daten, bei denen Sie überprüfen müssen, ob ein Wert zu Ihrem Enum gehört, bevor Sie ihn in typsicherem Code verwenden.