Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes