Accueil › TypeScript › Modificateurs et renommage de clés
Modificateurs et renommage de clés
Types mappés et littéraux de gabaritavance
Un type mappé peut ajouter ou retirer les modificateurs ? et
readonly.
type Partiel<T> = { [K in keyof T]+?: T[K] }; // le + est implicite
type Requis<T> = { [K in keyof T]-?: T[K] };
type Figé<T> = { +readonly [K in keyof T]: T[K] };
type Mutable<T> = { -readonly [K in keyof T]: T[K] };
Required<T> de la bibliothèque standard, c'est -?. Rien d'autre.
Mutable<T> n'existe pas dans la bibliothèque standard — vous l'écrivez en
une ligne avec -readonly.
Les deux se cumulent
type Config = { readonly hote: string; port?: number };
type Resolue = { -readonly [K in keyof Config]-?: Config[K] };
// { hote: string; port: number }
Renommer une clé
type Accesseurs<T> = {
[K in keyof T as `get${Capitalize<string & K>}`]: () => T[K];
};
type A = Accesseurs<{ nom: string; age: number }>;
// { getNom: () => string; getAge: () => number }
Supprimer une clé
type SansId<T> = { [K in keyof T as K extends "id" ? never : K]: T[K] };
type B = SansId<{ id: number; nom: string }>; // { nom: string }
Une clé renommée en never disparaît. C'est le seul mécanisme de filtrage
dont disposent les types mappés.
Les termes à connaître
- Modificateur
?oureadonlyposé sur une propriété. Un type mappé peut les ajouter avec+ou les retirer avec-.- `-?`
Le retrait du caractère optionnel. C'est l'unique mécanisme derrière
Required.- `-readonly`
Le retrait de la lecture seule. C'est ce qui fait fonctionner un
Mutable<T>écrit à la main.- Clause `as`
Le renommage de clé, introduit en TypeScript 4.1 :
{ [K in keyof T as NouvelleClé]: … }.- Clé `never`
Une clé renommée en
neverdisparaît du type produit. C'est la façon de filtrer des propriétés.- `Mutable`
Un utilitaire absent de la bibliothèque standard, qu'on écrit en une ligne avec
-readonly.
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.