Union (A | B)
Un type qui peut être l’un de plusieurs types.
Exemple
#function formatId(id: string | number): string {
if (typeof id === 'number') {
return `#${id.toString().padStart(4, '0')}`
}
return id.toUpperCase()
}
console.log(formatId(42))
console.log(formatId('cw-html'))#0042 CW-HTML
Définition et utilisation
#Une union relie des types avec une barre verticale : string | number désigne une valeur qui est soit une chaîne, soit un nombre. C’est l’un des mécanismes les plus utilisés de TypeScript, car les données des vrais programmes se présentent souvent sous plusieurs formes.
Sur une valeur de type union, vous ne pouvez utiliser immédiatement que ce qui est commun à tous ses membres. Pour utiliser les méthodes d’un type précis, il faut d’abord le restreindre, par exemple avec une vérification typeof.
Les unions de littéraux ("easy" | "medium" | "hard") sont un moyen simple et léger de lister les valeurs autorisées, souvent plus pratique qu’un enum.
Syntaxe
#type Name = TypeA | TypeB | TypeCPlus d’exemples
#function length(value: string | number) {
return value.length
}
// Erreur : Property 'length' does not exist on type 'string | number'.Bonnes pratiques
#- Lorsque les membres d’une union sont des objets, donnez-leur un champ commun avec une valeur littérale (par exemple
kind). Vous obtenez ainsi une union discriminée, facile à restreindre. - Un tableau d’éléments de types différents s’écrit
(string | number)[], et nonstring | number[].
Entrées associées
#- enum vs unionenum crée un ensemble de constantes, visible aussi à l’exécution comme un objet, alors qu’une union de littéraux n’est qu’un type, plus léger et sans code JavaScript.
- Restriction de type (narrowing)Déterminer un type plus précis pour une valeur à partir des vérifications présentes dans votre code.
- Unions discriminéesDes unions d’objets avec un champ d’étiquette commun qui permet de distinguer facilement les variantes.
- Intersection (A & B)Un type qui combine en même temps tous les champs de plusieurs types.
- 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.