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
Toptionnelles. 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.
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.