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

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.

Fontes