Formations — 1 037 leçons en français

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é à never rend never sans é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.

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.