Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Object.freeze: livello superiore non estensibile e non scrivibile

Object.freeze impedisce estensione e riconfigurazione delle proprietà proprie e rende non scrivibili le proprietà dati proprie.

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

Sintassi

Object.freeze(value)

Object.freeze(value) restituisce una primitiva invariata. Per un oggetto esegue SetIntegrityLevel al livello frozen: impedisce nuove proprietà, imposta configurable: false su ogni proprietà propria e anche writable: false sulle proprietà dati proprie. Restituisce lo stesso oggetto.

Una proprietà accessor mantiene getter e setter; perde solo la configurabilità. Il congelamento è superficiale: oggetti annidati, elementi privati e dati interni di Map e Set non diventano automaticamente immutabili. Un setter può ancora modificare stato annidato o esterno. L’immutabilità profonda richiede un attraversamento controllato e sicuro rispetto ai cicli del grafo dati.

Il metodo esiste da ECMAScript 5; la restituzione dei non-oggetti invece di un errore vale da ECMAScript 2015. Il fallimento di PreventExtensions o la violazione di invarianti da parte di un Proxy genera TypeError. Le typed array con elementi non possono essere congelate e generano anch’esse TypeError; una typed array vuota può esserlo.

Esempi

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); }

Risultato

true true
false false function false
true true
7
TypeError

L’esempio verifica attributi dati e accessor, congelamento superficiale, una primitiva e l’errore typed array.

Fonti