Générateur d'énumérations TypeScript

Les énumérations de chaînes attribuent des valeurs de chaîne à chaque membre, comme Color.Red équivaut à la chaîne RED. Les énumérations numériques attribuent des nombres incrémentiels commençant par 0 par défaut, donc Color.Red équivaut à 0 et Color.Bleu équivaut à 1. Les énumérations de chaînes sont préférables pour le débogage car les valeurs sont lisibles dans les journaux et les requêtes réseau. Les énumérations numériques sont légèrement plus compactes et supportent la cartographie inverse de manière native, ce qui signifie que vous pouvez rechercher le nom à partir du nombre. La plupart des projets TypeScript modernes privilégient les énumérations de chaînes pour leur clarté.

Les énumérations `const` sont complètement insérées à l'intégration de compilation. Le compilateur TypeScript remplace chaque référence à un membre d'énumération `const` par sa valeur littérale, donc aucun objet d'énumération n'existe en temps réel. Cela produit des tailles de bundle plus petites et une exécution plus rapide. Cependant, les énumérations `const` ne peuvent pas être itérées (pas `Object.values`), ne supportent pas la cartographie inverse, et peuvent poser problème avec les fichiers de déclaration dans le code de bibliothèque. Utilisez les énumérations `const` pour les constantes internes d'application où vous souhaitez un surcoût en temps réel nul. Utilisez des énumérations classiques lorsque vous avez besoin d'itérer les valeurs ou lors de la publication d'une bibliothèque.

Un objet de type `as const` utilise un simple objet JavaScript avec une assertion `const` pour obtenir un comportement similaire à une énumération. Par exemple, `const Couleur = { Rouge: 'ROUGE', Bleu: 'BLEU' } as const` crée un objet immuable où TypeScript infère les types littéraux. Cette méthode fonctionne aussi bien en TypeScript qu'en JavaScript, supporte mieux le *tree-shaking* que les énumérations et évite certaines casse-têtes lors de la transpilation des énumérations. Le compromis est une extraction légèrement plus verbeuse des types : il faut `type Couleur = typeof Couleur[keyof typeof Couleur]` pour obtenir un type union. De nombreux équipes privilégient désormais les objets `as const` par rapport aux énumérations pour ces raisons pratiques.

Une garde de type est une fonction qui affine le type d'une valeur en temps réel. Pour un énuméré, une garde de type vérifie si une chaîne ou un nombre correspond effectivement à un membre valide de l'énumération et informe le système de types de TypeScript du résultat. Par exemple, la fonction `isColor(value: string): value is Color` retourne vrai uniquement si la valeur correspond à un membre de l'énumération. Cela est utile lors de la validation des réponses d'API, des entrées de formulaire ou de toute donnée externe où vous avez besoin de confirmer qu'une valeur appartient bien à votre énumération avant de l'utiliser dans du code typé en sécurité.