Formations — 1 037 leçons en français

Accueil › TypeScript › Les types union

Les types union

Unions et affinagedebutant

Un type union décrit une valeur qui peut être de plusieurs types, et la barre verticale se lit « ou ».

type Identifiant = string | number;

function afficher(id: Identifiant) {
  console.log("id =", id);
}

afficher("a3f9");   // d'accord
afficher(42);       // d'accord
afficher(true);     // TS2345: Argument of type 'boolean' is not assignable
                    // to parameter of type 'Identifiant'.

Seuls les membres communs sont accessibles

C'est la règle qui surprend, et c'est la plus importante du chapitre.

function decrire(x: string | number) {
  x.toString();      // d'accord : présent sur les deux
  x.toUpperCase();   // TS2339: Property 'toUpperCase' does not exist on type
                     // 'string | number'. Property 'toUpperCase' does not
                     // exist on type 'number'.
}

TypeScript ne sait pas, à cet endroit du code, lequel des deux membres est réellement là. Il n'autorise donc que ce qui est vrai dans tous les cas. Ce n'est pas une limite du langage, c'est la seule réponse sûre : sur un nombre, toUpperCase n'est pas une erreur de type, c'est un plantage.

Les unions élargissent

let texte: string = "x";
let mixte: string | number = texte;   // d'accord
let retour: string = mixte;           // TS2322: Type 'string | number' is not
                                      // assignable to type 'string'.

On va toujours du plus précis vers le plus large. Pour redescendre, il faut prouver au compilateur quel membre est présent — c'est l'affinage, leçon suivante.

Les termes à connaître

Type union (`A | B`)

Un type dont les valeurs sont celles de A ou celles de B. string | number accepte "x" et 3, et rien d'autre. La barre verticale se lit « ou ».

Membre d'une union

Chacun des types réunis par |. Une union peut avoir deux membres ou vingt, et ses membres peuvent eux-mêmes être des unions : | est associatif et aplatit.

Accès commun

Sur une valeur de type union, seules les propriétés et méthodes présentes dans tous les membres sont accessibles. Tout le reste est une erreur TS2339 jusqu'à ce que le type soit affiné.

Union de littéraux

Une union dont les membres sont des valeurs précises : "brouillon" | "publie". C'est l'usage le plus fréquent et le plus rentable des unions.

Sens de l'affectation

Un string s'affecte à un string | number — l'union est plus large. L'inverse est refusé : un string | number n'est pas un string. Les unions élargissent, elles ne restreignent pas.

Union contre `any`

any désactive la vérification ; une union l'organise. string | number interdit .toFixed() avant affinage, any l'autorise et laisse planter à l'exécution.

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.