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

CKTIS / JavaScript

Reflect.preventExtensions — impedir a extensão de um objeto

Reflect.preventExtensions(target) impede a adição de novas propriedades próprias a um objeto e devolve um valor booleano. Não congela as propriedades existentes e ainda pode lançar exceções.

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

Reflect.preventExtensions(target)

Reflect.preventExtensions(target) invoca a operação interna [[PreventExtensions]] do objeto. Devolve true se a operação for bem-sucedida ou false se for recusada. O argumento tem de ser um objeto; um valor primitivo, incluindo null, provoca um TypeError. As exceções da operação interna são propagadas: o resultado booleano não significa que não possam ocorrer exceções.

Num objeto comum, o sucesso impede permanentemente a adição de novas propriedades próprias, incluindo as que têm chaves do tipo Symbol. Uma chamada posterior devolve true. Também deixa de ser possível alterar o protótipo para outro. As propriedades existentes ainda podem ser modificadas ou eliminadas se os respetivos descritores o permitirem; os objetos aninhados não são modificados.

Isto não equivale a Object.seal nem a Object.freeze: o método não altera os atributos configurable ou writable. Object.preventExtensions devolve o argumento em caso de sucesso e lança um TypeError quando a operação devolve false; devolve os valores primitivos sem os alterar. Reflect.preventExtensions expõe, em vez disso, o resultado booleano e rejeita valores primitivos.

Um Proxy pode intercetar a operação através da sua armadilha preventExtensions. A armadilha pode recusá-la devolvendo false, mas indicar sucesso enquanto o objeto-alvo continuar extensível provoca um TypeError. No exemplo, Reflect.set demonstra uma tentativa falhada de adicionar uma propriedade sem depender do modo estrito.

Exemplos

const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));

Resultado

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