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

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.

Fontes