Formations — 1 037 leçons en français

Accueil › TypeScript › Les types mappés

Les types mappés

Types mappés et littéraux de gabaritavance

Un type mappé parcourt les clés d'un type et en fabrique un nouveau.

type Identite<T> = { [K in keyof T]: T[K] };

type Client = { nom: string; age: number };
type Copie = Identite<Client>;      // { nom: string; age: number }

Trois morceaux, et c'est tout :

La forme ci-dessus ne fait rien. Tout l'intérêt vient de ce qu'on change.

Changer la valeur

type Messages<T> = { [K in keyof T]: string };

type ErreursClient = Messages<Client>;   // { nom: string; age: string }

Les clés viennent de T, les types ne viennent plus de lui. C'est le patron de tous les types de formulaire.

Les trois utilitaires, réimplémentés

type Partiel<T>  = { [K in keyof T]?: T[K] };
type Figé<T>     = { readonly [K in keyof T]: T[K] };
type Table<K extends keyof any, V> = { [P in K]: V };

Partial, Readonly et Record de la bibliothèque standard sont écrits exactement ainsi, à une ligne près. Il n'y a aucune magie de compilateur derrière eux : ce sont des types mappés comme les vôtres.

Les termes à connaître

Type mappé

Un type de la forme { [K in keyof T]: … } : il parcourt les clés d'un type et fabrique un nouveau type, une clé à la fois.

Clause `in`

La boucle du système de types. K in Union instancie le corps une fois par membre de l'union des clés.

Type indexé

T[K] — le type de la propriété K de T. C'est ce qui permet de réutiliser le type d'origine dans le corps du mappage.

Homomorphe

Un type mappé écrit [K in keyof T], qui conserve la structure de T — ses modificateurs, et son caractère tableau ou tuple.

Clé littérale

Une chaîne ou un nombre utilisé comme type. keyof T est l'union des clés littérales de T.

`Record`

Le type mappé le plus simple : il boucle sur une union de clés fournie, pas sur keyof T.

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.