Accueil › TypeScript › La distribution sur les unions
La distribution sur les unions
Types conditionnelsavance
Quand la condition porte sur un paramètre de type nu, le conditionnel ne voit pas l'union comme un bloc : il l'éclate, applique la condition à chaque membre, puis réunit les résultats.
type Boite<T> = T extends unknown ? T[] : never;
type R = Boite<string | number>; // string[] | number[]
Le compilateur a évalué Boite<string> puis Boite<number> et fait l'union.
Ce n'est pas (string | number)[].
C'est ce qui rend les filtres possibles
type Exclude<T, U> = T extends U ? never : T;
type Sansb = Exclude<"a" | "b" | "c", "b">; // "a" | "c"
Trois évaluations : "a" reste, "b" devient never, "c" reste. Et comme
never disparaît des unions, "a" | never | "c" vaut "a" | "c". Le filtre
est entièrement un effet de bord de la distribution.
Désactiver la distribution
Il suffit d'entourer les deux côtés de crochets :
type EstUnion<T> = [T] extends [unknown] ? "bloc" : never;
type A = Boite<string | number>; // string[] | number[]
type B = [string | number] extends [unknown]
? (string | number)[] : never; // (string | number)[]
Le tuple d'un élément n'est qu'un emballage : il empêche le paramètre d'être « nu », donc l'union est testée entière.
Le piège qui compte
type Toujours<T> = T extends unknown ? "oui" : "non";
type Z = Toujours<never>; // never — pas "oui"
never est l'union vide. Il n'y a aucun membre à parcourir, donc aucun
résultat : les branches ne sont jamais évaluées. Un cas disparaît sans aucune
erreur.
Les termes à connaître
- Distribution
Le comportement par défaut d'un conditionnel dont la condition porte sur un paramètre de type nu : l'union est éclatée, la condition appliquée à chaque membre, les résultats réunis.
- Type nu
Un paramètre de type seul à gauche du
extends, sans crochets ni intersection autour. C'est la condition de la distribution.- Désactivation
Entourer les deux côtés de crochets —
[T] extends [U]— supprime la distribution et teste l'union entière d'un bloc.- Filtre d'union
L'usage le plus fréquent de la distribution : une branche rend
never, et le membre correspondant disparaît du résultat.- never distribué
Un conditionnel distributif appliqué à
neverrendneversans évaluer aucune branche : l'union vide n'a aucun membre à parcourir.- Élargissement d'union
L'effet inverse du filtre : chaque membre peut être remplacé par un autre type, ce qui transforme l'union au lieu de la réduire.
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.