CKTIS / JavaScript
Object.isSealed — verificare se un oggetto è sigillato
Object.isSealed(value) verifica se un oggetto non è estensibile e se tutte le sue proprietà proprie non sono configurabili. Questo non implica che i valori siano immutabili né che gli oggetti annidati siano sigillati.
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.isSealed(value)Object.isSealed(value) restituisce true quando l’oggetto non è estensibile e ogni sua proprietà propria ha configurable: false. Il controllo include le proprietà non enumerabili e le chiavi Symbol, ma non le proprietà ereditate. Esamina lo stato; a differenza di Object.seal, non impone queste restrizioni.
Il sigillamento impedisce di aggiungere ed eliminare proprietà proprie e di apportare modifiche vietate dalla loro non configurabilità. Il sigillamento di per sé non modifica l’attributo writable. In un oggetto ordinario è ancora possibile assegnare un nuovo valore a una proprietà dati propria scrivibile. Negli oggetti esotici, invece, writable: true non garantisce che l’assegnazione riesca. Ad esempio, un oggetto namespace di modulo sigillato indica writable: true per i binding esportati, ma rifiuta le assegnazioni a tali binding. Object.isFrozen richiede inoltre che le proprietà dati proprie non siano scrivibili. Nessuno dei due controlli è ricorsivo.
Object.preventExtensions da solo in genere non basta se rimangono proprietà configurabili. Tuttavia, un oggetto vuoto non estensibile è sigillato. Nell’ECMAScript attuale, gli argomenti primitivi, inclusi null e undefined, restituiscono true; ciò non significa che siano oggetti.
Con un Proxy, il controllo può invocare trap e generare un’eccezione, quindi non è sempre un’ispezione priva di effetti collaterali. Questa è un’API del linguaggio ECMAScript, non un’API Web del browser; la specifica del linguaggio non è una tabella di compatibilità dei browser.
Esempi
const item = { count: 1, nested: { active: true } };
console.log(Object.isSealed(item));
Object.seal(item);
item.count = 2;
console.log(Object.isSealed(item));
console.log(Object.isFrozen(item));
console.log(item.count);
console.log(Object.isSealed(item.nested));
console.log(Object.isSealed(Object.preventExtensions({})));
console.log(Object.isSealed(null));Risultato
false true false 2 false 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.