Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Object.isFrozen — verificare se un oggetto è congelato

Object.isFrozen(value) verifica se un oggetto non è estensibile, se le sue proprietà proprie non sono configurabili e se le sue proprietà dati non sono scrivibili. Non congela l’oggetto e non controlla ricorsivamente gli oggetti annidati.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

Object.isFrozen(value)

Object.isFrozen(value) è un metodo statico che restituisce true quando non è possibile aggiungere proprietà proprie a un oggetto, tutte le sue proprietà proprie hanno configurable: false e le sue proprietà dati proprie hanno anche writable: false. Sono incluse le chiavi simboliche e le proprietà non enumerabili, ma non quelle ereditate.

Il metodo esamina lo stato invece di modificarlo; per congelare un oggetto usa Object.freeze. Object.seal da solo non basta se restano proprietà dati scrivibili. Un oggetto vuoto, tuttavia, è congelato dopo Object.preventExtensions, perché non ha proprietà che violino le altre condizioni.

Un risultato true non implica un’immutabilità profonda. Gli oggetti memorizzati come valori di proprietà possono comunque cambiare. Le proprietà accessor possono mantenere i setter e i getter possono restituire risultati variabili; il test non richiede di rimuoverli né invoca i getter di un oggetto ordinario.

Per i valori primitivi, compresi null e undefined, la specifica attuale restituisce true. Con un Proxy, l’ispezione può attivare trap e generare un’eccezione, quindi non è sempre un’operazione priva di effetti collaterali.

Esempi

const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));

Risultato

false
true
false
true
true
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti