CKTIS / JavaScript
Object.seal — selar um objeto
Object.seal impede a adição e a eliminação de propriedades próprias de um objeto, mas não o torna imutável. Num objeto ordinário, as propriedades de dados que permitem escrita podem continuar a receber novos valores, e os objetos aninhados não são selados automaticamente.
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.seal(obj)Object.seal(obj) modifica o objeto fornecido e devolve esse mesmo objeto, sem criar uma cópia. Impede a sua extensão e define configurable: false para todas as propriedades próprias, incluindo as não enumeráveis e as que têm chaves Symbol. Deixa de ser possível adicionar ou eliminar propriedades próprias, alterar a sua enumerabilidade ou converter propriedades de dados em acessores e vice-versa.
Selar não significa tornar imutável. Num objeto ordinário, as propriedades de dados existentes com writable: true podem continuar a receber novos valores, e é possível alterar writable de true para false, mas não no sentido inverso. Num objeto selado que representa o espaço de nomes de um módulo, os descritores das propriedades correspondentes às exportações indicam writable: true, mas o objeto rejeita tanto as atribuições a essas propriedades como as tentativas de definir o seu atributo writable como false. Os setters existentes podem continuar a funcionar. A operação é superficial: os objetos aninhados não são selados automaticamente.
Object.preventExtensions impede a adição de propriedades próprias, mas, por si só, não torna não configuráveis as propriedades existentes. Num objeto ordinário, Object.freeze define também writable: false para as propriedades de dados próprias; esta operação também é superficial. Verifique o estado de selagem com Object.isSealed.
Em modo estrito, uma atribuição não permitida a uma propriedade nova ou a eliminação de uma propriedade existente com delete provoca um TypeError; fora do modo estrito, estas operações geralmente falham sem lançar uma exceção. Object.seal pode lançar uma exceção se a selagem falhar, por exemplo, com alguns objetos Proxy. No ECMAScript moderno, um argumento que não seja um objeto é devolvido sem alterações.
Exemplos
"use strict";
const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;
console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);
try {
settings.extra = 1;
} catch (error) {
console.log(error instanceof TypeError);
}
console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));Resultado
true true 3 true true false false
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.