Accueil › TypeScript › Propriétés optionnelles et readonly
Propriétés optionnelles et readonly
Objets, interfaces et aliasdebutant
Deux modificateurs, deux garanties très différentes.
interface Client {
id: number;
nom: string;
email?: string; // peut être absente
readonly cree: string; // ne peut pas être réaffectée
}
?: ajoute undefined au type de la propriété. Sous strict, chaque lecture
doit en tenir compte :
function domaine(c: Client): string {
return c.email.split("@")[1];
// Erreur TS18048 : 'c.email' is possibly 'undefined'.
}
function domaineSur(c: Client): string | undefined {
return c.email?.split("@")[1]; // la garde est dans le code
}
readonly interdit l'écriture, et seulement elle :
const c: Client = { id: 1, nom: "Anne", cree: "2026-01-01" };
c.cree = "2026-02-01";
// Erreur TS2540 : Cannot assign to 'cree' because it is a read-only property.
La garantie n'existe qu'à la compilation
C'est le point à ne pas rater. readonly ne produit aucun JavaScript :
// Ce que vous écrivez
c.cree = "2026-02-01"; // refusé par le compilateur
// Le même objet, atteint autrement
(c as { cree: string }).cree = "2026-02-01"; // accepté, et la valeur change
const brut: { cree: string } = c; // puis brut.cree = …
readonly est une discipline d'écriture vérifiée par un outil, pas un verrou.
Pour un verrou réel, il faut Object.freeze, qui est du code.
Les termes à connaître
- Propriété optionnelle
nom?: stringdéclare une propriété qui peut être absente. Son type devientstring | undefined, et toute lecture doit traiter le casundefined.- Absente ou undefined
Deux situations distinctes que
?:confond par défaut : la clé manque, ou la clé existe et vautundefined.exactOptionalPropertyTypesles sépare.- readonly
Interdit la réaffectation d'une propriété à la compilation. Aucun code n'est produit : la propriété reste modifiable à l'exécution.
- Immuabilité superficielle
readonlyne protège que le niveau où il est écrit. Un objet imbriqué derrière une propriétéreadonlyreste entièrement modifiable.- Readonly<T>
Le type utilitaire qui ajoute
readonlyà toutes les propriétés d'un type — un seul niveau, lui aussi.- Object.freeze
La vraie protection à l'exécution. Elle gèle un objet pour de bon, mais seulement son premier niveau elle aussi.
- TS2540
« Cannot assign to 'x' because it is a read-only property. » L'erreur que produit une tentative d'écriture sur une propriété
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.