CKTIS / JavaScript
Object.isFrozen — verificar se um objeto está congelado
Object.isFrozen(value) verifica se um objeto não é extensível, se as suas propriedades próprias não são configuráveis e se as propriedades de dados também não são graváveis. Não congela o objeto nem verifica recursivamente os objetos aninhados.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
Object.isFrozen(value)Object.isFrozen(value) é um método estático que devolve true quando não é possível adicionar propriedades próprias a um objeto, todas as suas propriedades próprias têm configurable: false e as suas propriedades próprias de dados também têm writable: false. São incluídas as chaves de símbolo e as propriedades não enumeráveis, mas não as propriedades herdadas.
O método examina o estado em vez de o alterar; utiliza Object.freeze para congelar um objeto. Object.seal, por si só, não é suficiente se continuarem a existir propriedades de dados graváveis. No entanto, um objeto vazio fica congelado após Object.preventExtensions, porque não tem propriedades que violem as restantes condições.
Um resultado true não implica imutabilidade profunda. Os objetos guardados como valores de propriedades podem continuar a mudar. As propriedades acessoras podem manter setters e os getters podem devolver resultados variáveis; o teste não exige que sejam removidos nem invoca os getters de um objeto comum.
Para valores primitivos, incluindo null e undefined, a especificação atual devolve true. Com um Proxy, a inspeção pode acionar armadilhas e lançar uma exceção, pelo que nem sempre é uma operação sem efeitos secundários.
Exemplos
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));Resultado
false true false true true true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.