Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes