CKTIS / JavaScript
Reflect.deleteProperty — eliminar propriedades com um resultado booleano
Reflect.deleteProperty(target, propertyKey) tenta eliminar uma propriedade própria de um objeto e devolve um resultado booleano. Para um objeto comum, devolve true mesmo quando a propriedade não existe e false quando tem configurable: false.
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.deleteProperty(target, propertyKey)Reflect.deleteProperty(target, propertyKey) invoca a operação interna [[Delete]] do objeto. target tem de ser um objeto; um valor primitivo, incluindo null, causa um TypeError. propertyKey é convertido numa chave de propriedade: uma cadeia de caracteres ou um Symbol.
Num objeto comum, o método remove uma propriedade própria se o respetivo atributo configurable tiver o valor true. Nesse caso, devolve true; também devolve true quando não existe nenhuma propriedade própria. Uma propriedade com configurable: false mantém-se inalterada e o resultado é false. O método não elimina propriedades do protótipo: eliminar uma propriedade própria pode tornar visível uma propriedade herdada com a mesma chave.
Ao contrário de delete target[propertyKey] em modo estrito, o método devolve false em vez de lançar uma exceção apenas por a eliminação ter sido recusada. Isto não significa que nunca lance exceções: estas podem resultar da conversão da chave ou de um Proxy, cuja trap deleteProperty pode intercetar a operação e está sujeita aos invariantes da especificação.
O exemplo demonstra a eliminação, uma propriedade inexistente e uma eliminação recusada em modo estrito. Esta é uma função da biblioteca padrão ECMAScript, não uma API Web. A especificação, por si só, não comprova o suporte numa versão específica de um navegador; a presença de Node 24 num repositório também não o comprova.
Exemplos
"use strict";
const item = { temporary: 1 };
Object.defineProperty(item, "fixed", {
value: 2,
configurable: false
});
console.log(Reflect.deleteProperty(item, "temporary"));
console.log(Reflect.deleteProperty(item, "missing"));
console.log(Reflect.deleteProperty(item, "fixed"));
console.log(Object.prototype.hasOwnProperty.call(item, "temporary"));
console.log(item.fixed);Resultado
true true false false 2
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.