CKTIS / JavaScript
Reflect.has — verificar se uma propriedade existe
`Reflect.has(target, propertyKey)` devolve um valor booleano. Se o objeto e todos os seus protótipos forem objetos comuns, distingue uma propriedade em falta de uma propriedade própria ou herdada que existe, mesmo que o seu valor seja `undefined`. A armadilha `has` de um `Proxy` pode alterar o resultado.
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.has(target, propertyKey)Reflect.has(target, propertyKey) verifica a existência de uma propriedade, não o seu valor. Se o objeto e todos os seus protótipos forem objetos comuns, procura no objeto e na respetiva cadeia de protótipos e devolve true ou false. Uma propriedade cujo valor é undefined continua a existir; o facto de ser enumerável não é relevante.
É a forma funcional de propertyKey in target. Se quiseres verificar apenas propriedades próprias, usa Object.hasOwn(target, propertyKey): ao contrário de Reflect.has, exclui as propriedades herdadas.
target tem de ser um objeto; um valor primitivo, incluindo null ou undefined, causa um TypeError. propertyKey é convertido numa chave de propriedade: uma cadeia de caracteres ou um símbolo. Por exemplo, o número 0 indica a chave "0". Os erros de conversão são propagados para quem chamou o método.
O método invoca a operação interna [[HasProperty]]. Se a pesquisa encontrar um Proxy, pode ativar a sua armadilha has. A armadilha pode alterar o resultado booleano: pode indicar que uma propriedade em falta existe ou ocultar uma propriedade própria configurável existente num objeto alvo extensível. A verificação também pode ter efeitos secundários ou lançar uma exceção. No exemplo, own existe apesar de ter o valor undefined, enquanto inherited só é encontrado pela verificação que considera o protótipo.
Exemplos
const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;
console.log(Reflect.has(item, "own"));
console.log(Reflect.has(item, "inherited"));
console.log(Reflect.has(item, "missing"));
console.log(Object.hasOwn(item, "inherited"));Resultado
true true false 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.