CKTIS / JavaScript
Proxy — intercetar leituras e escritas de propriedades
Proxy cria um objeto que medeia operações sobre um objeto de destino. Os métodos handler.get e handler.set permitem calcular valores durante a leitura e controlar escritas, respeitando os invariantes da linguagem.
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
new Proxy(target, { get(target, property, receiver) { /* return value */ }, set(target, property, value, receiver) { /* return boolean */ } })new Proxy(target, handler) cria um objeto intermediário separado; não copia target. As operações realizadas diretamente em target ignoram as armadilhas. Se uma armadilha não existir, a operação correspondente é encaminhada para o objeto de destino.
Proxy handler.get, escrito como get(target, property, receiver), interceta leituras de propriedades e devolve o valor. property é uma cadeia de caracteres ou um símbolo. receiver é o recetor da operação, normalmente o proxy; passá-lo a Reflect.get(target, property, receiver) preserva o this adequado nos getters.
Proxy handler.set, escrito como set(target, property, value, receiver), interceta escritas. O resultado é convertido num booleano: true significa sucesso e false significa rejeição. Uma atribuição rejeitada em modo estrito lança um TypeError. Devolver true, por si só, não guarda o valor; Reflect.set(target, property, value, receiver) executa a operação e devolve o resultado.
As armadilhas têm de respeitar os invariantes: para uma propriedade de dados própria, não configurável e não gravável, get não pode devolver um valor diferente, e set não pode indicar que a escrita de um valor diferente foi bem-sucedida. As violações lançam um TypeError. No exemplo, double é calculado e a escrita inválida de score é rejeitada.
Exemplos
"use strict";
const target = { score: 0 };
const proxy = new Proxy(target, {
get(target, property, receiver) {
if (property === "double") return target.score * 2;
return Reflect.get(target, property, receiver);
},
set(target, property, value, receiver) {
if (property === "score" && !Number.isInteger(value)) return false;
return Reflect.set(target, property, value, receiver);
}
});
proxy.score = 7;
console.log(proxy.score);
console.log(proxy.double);
try {
proxy.score = 1.5;
} catch (error) {
console.log(error.name);
}
console.log(target.score);Resultado
7 14 TypeError 7
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.