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

CKTIS / JavaScript

Object.isSealed — verificar se um objeto está selado

Object.isSealed(value) verifica se um objeto não é extensível e se todas as suas propriedades próprias são não configuráveis. Isto não implica que os valores sejam imutáveis nem que os objetos aninhados estejam selados.

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.isSealed(value)

Object.isSealed(value) devolve true quando o objeto não é extensível e cada propriedade própria tem configurable: false. A verificação inclui propriedades não enumeráveis e chaves Symbol, mas não propriedades herdadas. Inspeciona o estado; ao contrário de Object.seal, não impõe estas restrições.

O selamento impede a adição e a remoção de propriedades próprias, bem como alterações proibidas pelo seu caráter não configurável. O selamento, por si só, não altera o atributo writable. Num objeto comum, continua a ser possível atribuir um novo valor a uma propriedade de dados própria que seja gravável. Nos objetos exóticos, porém, writable: true não garante que a atribuição seja bem-sucedida. Por exemplo, um objeto selado que representa o espaço de nomes de um módulo indica writable: true para as suas ligações exportadas, mas rejeita atribuições a essas ligações. Object.isFrozen exige também que as propriedades de dados próprias não sejam graváveis. Nenhuma das verificações é recursiva.

Object.preventExtensions, por si só, geralmente não é suficiente se ainda existirem propriedades configuráveis. No entanto, um objeto vazio não extensível está selado. No ECMAScript atual, os argumentos primitivos, incluindo null e undefined, devolvem true; isto não significa que sejam objetos.

Com um Proxy, a verificação pode invocar armadilhas e lançar uma exceção, pelo que nem sempre é uma inspeção sem efeitos secundários. Esta é uma API da linguagem ECMAScript, não uma API Web do navegador; a especificação da linguagem não é uma tabela de compatibilidade dos navegadores.

Exemplos

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));

Resultado

false
true
false
2
false
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