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.