Formations — 1 037 leçons en français

Accueil › TypeScript › Partial, Required, Readonly

Partial, Required, Readonly

Les types utilitairesintermediaire

Les types utilitaires transforment un type existant. Trois d'entre eux touchent aux modificateurs des propriétés — le ? et le readonly — sans toucher aux clés.

type Client = {
  id: number;
  nom: string;
  email: string;
};

type MaJClient = Partial<Client>;
// { id?: number; nom?: string; email?: string }

type ClientFige = Readonly<Client>;
// { readonly id: number; readonly nom: string; readonly email: string }

Partial<T> pose un ? sur chaque propriété. C'est le type naturel d'un objet de mise à jour : on envoie les champs qui changent, pas les autres — et {} devient une valeur valide.

Required<T> fait l'inverse, et sert surtout après une fusion avec des valeurs par défaut : la configuration arrive partielle, elle ressort complète.

Readonly<T> marque tout en lecture seule. Le compilateur refuse alors client.nom = "x" avec TS2540 : impossible d'affecter « nom », car il s'agit d'une propriété en lecture seule.

Les deux choses à savoir d'emblée

Ces trois utilitaires sont superficiels. Ils ne descendent pas dans les objets imbriqués. Partial<Client> rend adresse optionnelle, mais le contenu de adresse reste entièrement obligatoire.

Readonly n'existe pas à l'exécution. Rien n'est gelé. C'est une promesse faite au compilateur, effacée à la compilation.

Les termes à connaître

Type utilitaire

Un type générique fourni par la bibliothèque standard de TypeScript, qui transforme un type existant en un autre. Il n'y a rien à installer : ils sont déclarés dans lib.es5.d.ts.

`Partial<T>`

Rend toutes les propriétés de T optionnelles. S'écrit { [K in keyof T]?: T[K] } — un type mappé de trois lignes.

`Required<T>`

L'inverse : retire l'optionnalité de toutes les propriétés. Le modificateur -? supprime le ? au lieu de l'ajouter.

`Readonly<T>`

Marque toutes les propriétés en lecture seule. Le compilateur refuse l'affectation ; rien n'est gelé à l'exécution.

Superficiel

Se dit d'une transformation qui ne s'applique qu'au premier niveau de l'objet. Les trois utilitaires de cette leçon sont superficiels.

Type mappé

La construction { [K in keyof T]: … } qui parcourt les clés d'un type pour en fabriquer un autre. C'est le mécanisme dont tous ces utilitaires sont faits.

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.