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
Aou celles deB.string | numberaccepte"x"et3, 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
strings'affecte à unstring | number— l'union est plus large. L'inverse est refusé : unstring | numbern'est pas unstring. Les unions élargissent, elles ne restreignent pas.- Union contre `any`
anydésactive la vérification ; une union l'organise.string | numberinterdit.toFixed()avant affinage,anyl'autorise et laisse planter à l'exécution.
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.