CKTIS / JavaScript
Reflect.get — ler uma propriedade com um receiver opcional
`Reflect.get` lê uma propriedade de um objeto, incluindo uma propriedade herdada. Numa pesquisa normal, o receiver é passado ao getter como argumento `this`, sem alterar o ponto de partida da pesquisa.
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.get(target, propertyKey[, receiver])Reflect.get(target, propertyKey[, receiver]) executa a operação interna [[Get]]. Num objeto comum, procura a propriedade em target e, em seguida, ao longo da cadeia de protótipos. Uma propriedade inexistente produz undefined; um acessor sem getter também produz undefined.
Se receiver for omitido, o seu valor predefinido é target. Numa pesquisa normal de propriedades, receiver é passado como argumento this ao chamar o getter, mesmo que este seja herdado. Isto não garante que this dentro do getter seja igual a receiver. Um getter com um valor de this já associado passa esse valor à função subjacente, em vez do argumento this recebido na chamada. Uma função de seta usada como getter ignora o argumento this e utiliza o this do seu âmbito léxico, mesmo que tenha sido definida em modo não estrito. Numa função em modo não estrito cujo this não esteja associado lexicalmente, um argumento this com o valor null ou undefined é substituído pelo valor global de this da função, e os restantes valores primitivos são convertidos em objetos. O receiver não substitui target como ponto de partida da procura. Ao ler uma propriedade de dados comum, é devolvido o valor encontrado, não uma propriedade de receiver.
target tem de ser um objeto: um valor primitivo, null ou undefined provoca um TypeError, em vez de converter automaticamente o valor primitivo num objeto. propertyKey é convertido numa chave de propriedade do tipo cadeia ou símbolo. A leitura pode executar o código de um getter ou a armadilha get de um objeto Proxy; Reflect.get não interceta exceções.
Utiliza este método quando precisares de controlar explicitamente o receiver de um getter. A leitura, por si só, não verifica se uma propriedade existe: undefined pode significar que a propriedade não existe ou que esse é o seu valor atual.
Exemplos
const prototype = {
get greeting() {
return `Hello, ${this.name}`;
}
};
const target = Object.create(prototype);
target.name = "Ada";
const receiver = { name: "Lin" };
console.log(Reflect.get(target, "greeting"));
console.log(Reflect.get(target, "greeting", receiver));
console.log(Reflect.get(target, "name", receiver));
console.log(Reflect.get(target, "missing"));Resultado
Hello, Ada Hello, Lin Ada undefined
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.