Accueil › TypeScript › enum, ou union de littéraux
enum, ou union de littéraux
Tableaux, tuples et enumsdebutant
Deux façons de décrire un ensemble fermé de valeurs. Elles n'ont pas le même coût.
// Union de littéraux
type Statut = "brouillon" | "publie" | "archive";
function publier(s: Statut) {}
publier("publie"); // direct
publier("publié"); // Erreur ts(2345) : accent en trop
// enum
enum Statut2 { Brouillon = "brouillon", Publie = "publie" }
function publier2(s: Statut2) {}
publier2(Statut2.Publie); // le seul appel possible
publier2("publie"); // Erreur ts(2345), pourtant la valeur est juste
Préférez l'union de littéraux dans la quasi-totalité des cas. Trois raisons, dans cet ordre :
- Aucun code produit. Une union est un type : elle disparaît à la
compilation. Un
enumcrée un objet JavaScript réel, qu'il faut importer et qui reste dans le paquet livré. - Aucune valeur à l'exécution à manipuler. La donnée est déjà la chaîne
"publie": rien à convertir en entrant d'une API, rien à reconvertir en sortant. - Une erreur de compilation sur une valeur inconnue.
"publié"est refusé avects(2345), et le message cite les trois valeurs admises.
Le motif qui remplace un enum quand une liste est nécessaire à l'exécution :
const STATUTS = ["brouillon", "publie", "archive"] as const;
type Statut = (typeof STATUTS)[number]; // "brouillon" | "publie" | "archive"
Une seule source de vérité, l'union dérivée de la liste. Ajouter une valeur au tableau met à jour le type.
Les termes à connaître
- Union de littéraux
type Statut = "brouillon" | "publie". Un ensemble fermé de valeurs, vérifié à la compilation, qui ne produit aucun code. Le choix par défaut.- `enum`
Une construction qui crée à la fois un type et un objet JavaScript réel. C'est la seule syntaxe de type de TypeScript qui survive à la compilation.
- `enum` numérique
Un
enumdont les membres valent0,1,2… par défaut. Les valeurs fuient dans les journaux et les bases de données sous forme de nombres sans signification.- `enum` de chaînes
Un
enumdont chaque membre a une valeur textuelle. Il se comporte de façon quasi nominale : la chaîne"rouge"n'est pas acceptée là oùCouleur.Rougeest attendu.- `const enum`
Un
enumdont les usages sont remplacés par leur valeur à la compilation. Incompatible avec les compilateurs qui traitent un fichier à la fois, et refusé en ambiant sousisolatedModules.- `erasableSyntaxOnly`
L'option introduite par TypeScript 5.8 qui interdit toute syntaxe produisant du code —
enum,namespace, propriétés de paramètre. Elle existe parce que les exécutables modernes ne savent qu'effacer les types.- Objet `as const` + `keyof typeof`
Le motif qui remplace un
enum: un objet figé pour les valeurs à l'exécution, ettypeof OBJ[keyof typeof OBJ]pour l'union de littéraux correspondante.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.