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.