CKTIS / JavaScript
Reflect — operações explícitas sobre objetos
Reflect disponibiliza métodos estáticos para ler, escrever e inspecionar objetos. O resultado booleano de uma escrita permite verificar se a operação foi bem-sucedida, mas não significa que o método nunca possa lançar uma exceção.
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, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)Reflect é um objeto integrado de ECMAScript, não uma função nem um construtor: Reflect() e new Reflect() lançam um TypeError. Os seus métodos expõem operações correspondentes aos mecanismos internos dos objetos.
Reflect.get lê uma propriedade, enquanto Reflect.set tenta escrevê-la e devolve um booleano, não o valor atribuído. Em ambos os métodos, o parâmetro opcional receiver é target por predefinição e determina o valor de this ao invocar getters ou setters. Reflect.ownKeys devolve todas as chaves próprias de cadeia de caracteres e símbolo, incluindo as não enumeráveis; exclui as herdadas.
Reflect.defineProperty devolve false quando um objeto rejeita um descritor válido, ao passo que Object.defineProperty lança uma exceção nessa situação. Um resultado booleano não garante a ausência de exceções: argumentos inválidos e código em getters, setters ou armadilhas de Proxy podem provocá-las. As operações sobre propriedades exigem que target seja um objeto.
No exemplo, a propriedade não é enumerável nem gravável. Reflect.set devolve false mesmo em modo estrito, o valor permanece 10 e Reflect.ownKeys continua a encontrar a chave.
Exemplos
"use strict";
const target = {};
Reflect.defineProperty(target, "score", {
value: 10,
writable: false,
enumerable: false,
configurable: false
});
console.log(Reflect.get(target, "score"));
console.log(Reflect.set(target, "score", 20));
console.log(Reflect.ownKeys(target).join(","));
console.log(Reflect.get(target, "score"));Resultado
10 false score 10
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.