Formations — 1 037 leçons en français

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

? ou readonly posé 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 never disparaî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.

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.