Accueil › TypeScript › Les unions discriminées
Les unions discriminées
Unions et affinagedebutant
Une union discriminée est une union d'objets qui partagent une propriété dont le type est un littéral différent dans chaque membre.
type Forme =
| { sorte: "cercle"; rayon: number }
| { sorte: "rectangle"; largeur: number; hauteur: number }
| { sorte: "carre"; cote: number };
function aire(f: Forme): number {
switch (f.sorte) {
case "cercle": return Math.PI * f.rayon ** 2;
case "rectangle": return f.largeur * f.hauteur;
case "carre": return f.cote ** 2;
}
}
sorte est le discriminant. Dans chaque case, TypeScript sait quel
membre est présent, et n'expose que ses propriétés. f.rayon dans le cas
rectangle est une erreur de compilation, pas un undefined à l'exécution.
Le vrai bénéfice : les états impossibles disparaissent
Comparez deux façons de décrire un chargement.
// Trois booléens indépendants : huit combinaisons, cinq absurdes
type Mauvais = { chargement: boolean; reussi: boolean; erreur: string | null };
const absurde: Mauvais = { chargement: true, reussi: true, erreur: "500" };
// parfaitement valide pour le compilateur, parfaitement impossible en vrai
// Trois variantes : trois états, tous légitimes
type Bon =
| { phase: "chargement" }
| { phase: "ok"; donnees: string[] }
| { phase: "erreur"; message: string };
const absurde2: Bon = { phase: "ok", message: "500" };
// TS2353: Object literal may only specify known properties, and 'message'
// does not exist in type '{ phase: "ok"; donnees: string[]; }'.
L'état impossible n'est pas détecté : il est inexprimable. Il n'y a plus rien à tester, parce qu'il n'y a plus rien à craindre.
Les termes à connaître
- Union discriminée
Une union d'objets dont chaque membre porte une propriété commune typée par un littéral différent. Tester cette propriété affine vers un seul membre.
- Discriminant
La propriété qui nomme la variante :
sorte,type,statut,kind. Son type doit être un littéral dans chaque membre —stringne discrimine rien.- État impossible inexprimable
Le bénéfice principal : une combinaison de données qui n'a pas de sens métier n'a plus de type qui l'accepte. Le code qui la produirait ne compile pas.
- Explosion combinatoire des booléens
Trois booléens indépendants décrivent huit états, dont la plupart sont absurdes. Une union discriminée de trois variantes en décrit trois, toutes valides.
- `switch` sur le discriminant
La forme canonique de traitement : chaque
caseaffine vers une variante, et l'éditeur propose les propriétés de cette variante seule.- Champ propre à une variante
Une propriété qui n'existe que dans un membre —
erreurdans l'échec,donneesdans le succès. C'est ce qui rend l'accès hors contexte impossible.
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.