Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Object.freeze : niveau supérieur non extensible et non modifiable

Object.freeze interdit l’extension et la reconfiguration des propriétés propres, et rend les propriétés de données propres non modifiables.

Version : ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2

Syntaxe

Object.freeze(value)

Object.freeze(value) renvoie une primitive inchangée. Pour un objet, la méthode exécute SetIntegrityLevel au niveau frozen : elle interdit de nouvelles propriétés, met configurable: false sur chaque propriété propre et aussi writable: false sur chaque propriété de données propre. Elle renvoie le même objet.

Une propriété d’accesseur conserve getter et setter ; seule sa configurabilité disparaît. Le gel est superficiel : objets imbriqués, éléments privés et données internes de Map ou Set ne deviennent pas automatiquement immuables. Un setter peut encore modifier un état imbriqué ou externe. L’immuabilité profonde exige un parcours contrôlé et résistant aux cycles du graphe.

La méthode existe depuis ECMAScript 5 ; le renvoi des non-objets au lieu d’une exception date d’ECMAScript 2015. Un échec de PreventExtensions ou une violation d’invariant par Proxy lève TypeError. Une typed array contenant des éléments ne peut être gelée et lève aussi TypeError, contrairement à une typed array vide.

Exemples

const config = {
  nested: { enabled: false },
  get status() { return this.nested.enabled; },
  set status(value) { this.nested.enabled = value; }
};
const same = Object.freeze(config);
const nested = Object.getOwnPropertyDescriptor(config, "nested");
const status = Object.getOwnPropertyDescriptor(config, "status");
console.log(same === config, Object.isFrozen(config));
console.log(nested.writable, nested.configurable, typeof status.set, status.configurable);
config.status = true;
console.log(config.nested.enabled, config.status);
console.log(Object.freeze(7));
try { Object.freeze(new Uint8Array([1])); }
catch (error) { console.log(error.name); }

Résultat

true true
false false function false
true true
7
TypeError

L’exemple confirme les attributs de données et d’accesseur, le gel superficiel, une primitive et l’erreur typed array.

Sources