Formations — 1 037 leçons en français

Accueil › TypeScript › private,

private,

Les classes en TypeScriptintermediaire

Deux mots pour dire « privé », et une seule vraie protection.

class CompteTs {
  private solde = 100;
}

class CompteJs {
  #solde = 100;
}

const a = new CompteTs();
const b = new CompteJs();

(a as any).solde;        // 100 — la propriété est là
(b as any).solde;        // undefined
Object.keys(a);          // ["solde"]
Object.keys(b);          // []
JSON.stringify(b);       // "{}"

private est une règle du vérificateur de types. Elle attrape les accès fautifs que vous écrivez, et elle est effacée à la compilation : il ne reste qu'une propriété ordinaire que as any, Object.keys, un JSON.stringify ou le débogueur atteignent sans effort.

#solde est une construction de JavaScript. Le moteur l'applique. Hors du corps de la classe, b.#solde n'est même pas compilable — ce n'est pas une erreur de type mais de syntaxe.

La conséquence pratique

// une donnée sensible dans un objet envoyé au client
class Session {
  constructor(public utilisateur: string, private jeton: string) {}
}
JSON.stringify(new Session("astra", "eyJ…"));
// {"utilisateur":"astra","jeton":"eyJ…"}  ← le jeton part sur le réseau

Avec #jeton, la sérialisation ne contient que l'utilisateur. Dès que la confidentialité a un enjeu — un secret, une invariante qu'un appelant JavaScript ne doit pas casser —, # est le bon choix.

Les termes à connaître

private

Modificateur TypeScript. Garantie de compilation seulement : la propriété reste une propriété ordinaire dans le JavaScript produit.

Champ privé

Un champ nommé #nom. Construction de JavaScript lui-même : l'accès hors de la classe est une erreur de syntaxe, et la donnée est invisible de l'extérieur.

readonly

Interdit la réaffectation du champ après construction. Vérifié à la compilation, effacé ensuite, et non profond.

Brand nominal

Un champ privé inutilisé qui rend une classe incompatible avec toute autre de même forme, malgré le typage structurel.

Accesseur

Un couple get/set qui expose une valeur dérivée ou contrôlée sans exposer le champ qui la porte.

WeakMap

La technique de confidentialité d'avant les champs # : la donnée vit hors de l'objet, indexée par l'instance.

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.