Formations — 1 037 leçons en français

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?: string déclare une propriété qui peut être absente. Son type devient string | undefined, et toute lecture doit traiter le cas undefined.

Absente ou undefined

Deux situations distinctes que ?: confond par défaut : la clé manque, ou la clé existe et vaut undefined. exactOptionalPropertyTypes les 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

readonly ne protège que le niveau où il est écrit. Un objet imbriqué derrière une propriété readonly reste 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.

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.