Unions discriminées
Des unions d’objets avec un champ d’étiquette commun qui permet de distinguer facilement les variantes.
Exemple
#type RequestState =
| { status: 'loading' }
| { status: 'success'; data: string[] }
| { status: 'error'; message: string }
function render(state: RequestState): string {
switch (state.status) {
case 'loading':
return 'Chargement…'
case 'success':
return `Cours : ${state.data.join(', ')}`
case 'error':
return `Erreur : ${state.message}`
}
}
console.log(render({ status: 'loading' }))
console.log(render({ status: 'success', data: ['HTML', 'CSS'] }))
console.log(render({ status: 'error', message: 'Pas de connexion' }))Chargement… Cours : HTML, CSS Erreur : Pas de connexion
Définition et utilisation
#Une union discriminée est une union de types d’objets où chaque variante possède un champ commun avec une valeur littérale différente, par exemple type: "text" | "image". Ce champ joue le rôle d’étiquette.
Après avoir vérifié l’étiquette (if (block.type === "image"), ou un switch), le compilateur sait exactement à quelle variante il a affaire et vous donne accès à ses champs.
C’est le motif de base pour modéliser des états (chargement, succès, erreur), des événements, des messages ou des types de tâches. Associé à never dans la branche default, il permet de vérifier l’exhaustivité.
Syntaxe
#type A = { kind: "a"; … }
type B = { kind: "b"; … }
type Union = A | BBonnes pratiques
#- Modélisez l’état comme une union discriminée plutôt que comme plusieurs drapeaux séparés (
isLoading,error,data). Les combinaisons impossibles cessent d’être possibles. - Ajoutez une branche
defaultavecassertNever, afin que le compilateur vous avertisse des variantes non gérées.
Entrées associées
#- Union (A | B)Un type qui peut être l’un de plusieurs types.
- neverLe type d’une valeur qui ne se produit jamais : des fonctions qui ne se terminent pas normalement, et des cas impossibles.
- Restriction de type (narrowing)Déterminer un type plus précis pour une valeur à partir des vérifications présentes dans votre code.
- Types littérauxDes types qui n’autorisent que des valeurs précises, par ex. "easy" | "hard".
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.