Formations — 1 037 leçons en français

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 :

  1. Aucun code produit. Une union est un type : elle disparaît à la compilation. Un enum crée un objet JavaScript réel, qu'il faut importer et qui reste dans le paquet livré.
  2. 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.
  3. Une erreur de compilation sur une valeur inconnue. "publié" est refusé avec ts(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 enum dont les membres valent 0, 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 enum dont 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.Rouge est attendu.

`const enum`

Un enum dont les usages sont remplacés par leur valeur à la compilation. Incompatible avec les compilateurs qui traitent un fichier à la fois, et refusé en ambiant sous isolatedModules.

`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, et typeof OBJ[keyof typeof OBJ] pour l'union de littéraux correspondante.

Lire l'explication détaillée et faire le quiz →

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.