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.