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

CKTIS / JavaScript

Object.preventExtensions — impedir novas propriedades

Object.preventExtensions(obj) impede de forma irreversível a adição de propriedades próprias a um objeto e devolve esse mesmo objeto. Não congela os valores existentes nem 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.preventExtensions(obj)

Object.preventExtensions(obj) torna um objeto não extensível: não é possível adicionar novas propriedades próprias, incluindo propriedades com chaves symbol. O método altera o objeto fornecido e devolve a mesma referência, não uma cópia. Utilize Object.isExtensible(obj) para verificar o seu estado. A operação não pode ser revertida.

Num objeto comum, as propriedades existentes mantêm os seus descritores: continua a ser possível atribuir valores às propriedades graváveis e eliminar as configuráveis. Uma propriedade eliminada não pode voltar a ser adicionada. Também não é permitido substituir o protótipo por outro; continua a ser permitido indicar o protótipo existente.

Um array tipado de comprimento fixo que utiliza um ArrayBuffer não redimensionável pode tornar-se não extensível, mas não é possível eliminar os seus elementos indexados existentes, embora os respetivos descritores indiquem configurable: true.

Uma atribuição que criaria uma nova propriedade própria lança TypeError em modo estrito e, normalmente, é ignorada fora desse modo. Object.defineProperty lança TypeError quando se tenta adicionar uma propriedade, independentemente do modo. O próprio método também lança TypeError se a operação interna recusar impedir a extensão, por exemplo, devido a uma armadilha de Proxy que devolve false. No ECMAScript atual, os argumentos primitivos, incluindo null e undefined, são devolvidos sem alterações.

Object.seal oferece uma proteção mais forte: define configurable como false para todas as propriedades próprias, pelo que não podem ser eliminadas. Num objeto comum selado, o atributo writable de uma propriedade de dados gravável pode ainda ser alterado de true para false. Um objeto selado que representa o espaço de nomes de um módulo indica writable: true nos descritores das propriedades que correspondem às ligações exportadas, mas não permite alterar esse atributo para false. Num objeto comum, Object.freeze define também writable como false para todas as propriedades de dados próprias do objeto. Num objeto que representa o espaço de nomes de um módulo, Object.freeze lança TypeError quando tenta definir writable como false para uma propriedade que corresponde a uma ligação exportada. Se essa ligação ainda não tiver sido inicializada, a consulta do descritor da propriedade pode lançar ReferenceError antes dessa tentativa. Nenhuma destas operações afeta recursivamente os objetos aninhados. Esta é uma API da linguagem ECMAScript, não uma Web API de navegador; a norma, por si só, não comprova o suporte num navegador específico.

Exemplos

"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
  item.extra = 3;
} catch (error) {
  console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));

Resultado

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