CKTIS / JavaScript
Reflect.getOwnPropertyDescriptor — examinar uma propriedade própria
Reflect.getOwnPropertyDescriptor(target, key) devolve o descritor de uma propriedade própria ou undefined. Permite examinar o valor, os acessores e os atributos de uma propriedade sem percorrer a cadeia de protótipos.
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.getOwnPropertyDescriptor(target, key)Reflect.getOwnPropertyDescriptor(target, key) descreve apenas uma propriedade própria de target, incluindo uma propriedade não enumerável. Devolve um novo objeto descritor ou undefined se a propriedade não for própria. Não procura propriedades herdadas na cadeia de protótipos; uma propriedade própria cujo valor seja undefined continua a ter um descritor.
Um descritor de dados contém value, writable, enumerable e configurable. Um descritor de acesso contém get e set em vez de value e writable; os respetivos valores são funções ou undefined. Examinar o descritor de um objeto comum não invoca o seu getter. Alterar o descritor devolvido não redefine, por si só, a propriedade; para isso, use, por exemplo, Object.defineProperty.
target tem de ser um objeto; qualquer valor primitivo, incluindo null e undefined, causa um TypeError. Isto difere de Object.getOwnPropertyDescriptor, que encapsula valores primitivos diferentes de null e undefined. A operação ToPropertyKey converte key numa chave de propriedade. Se key for um objeto, a operação converte-o primeiro num valor primitivo, por exemplo, através de uma chamada ao seu método Symbol.toPrimitive. Se o valor primitivo for um símbolo, este é mantido como chave; caso contrário, o valor é convertido numa cadeia de caracteres.
Não assuma que a operação é sempre isenta de efeitos secundários: a conversão de key pode executar código do utilizador e um Proxy pode acionar a sua armadilha getOwnPropertyDescriptor. As exceções resultantes são propagadas para quem fez a chamada. O exemplo mostra que uma propriedade herdada é ignorada e que alterar descriptor.value não altera item.score.
Exemplos
const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);Resultado
{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42O 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.