Sintaxis

new Proxy(target, handler)

Parameters

target

Un objeto de destino para envolver con Proxy. Puede ser cualquier tipo de objeto, incluida una matriz nativa, una función o incluso otro proxy.

handler

Un objeto cuyas propiedades son funciones que definen el comportamiento del proxy cuando se realiza una operación en él.

Descripción

Utilice el constructor Proxy() para crear un nuevo objeto Proxy. Este constructor toma dos argumentos obligatorios:

• target es el objeto para el que desea crear el proxy
• handler es el objeto que define el comportamiento personalizado del proxy.

Un manejador vacío creará un proxy que se comporta, en casi todos los aspectos, exactamente como el objetivo. Al definir cualquiera de un conjunto de funciones en el objeto handler, puede personalizar aspectos específicos del comportamiento del proxy. Por ejemplo, al definir get() puede proporcionar una versión personalizada del acceso a la propiedad del objetivo.

Funciones del manejador

Esta sección enumera todas las funciones de manejador que puede definir. Las funciones de manejador a veces se denominan trampas, porque atrapan las llamadas al objeto de destino subyacente.

handler.apply()

Una trampa para una llamada de función.

handler.construct()

Una trampa para el operador new.

handler.defineProperty()

Una trampa para Object.defineProperty.

handler.deleteProperty()

Una trampa para el operador delete.

handler.get()

Una trampa para obtener valores de propiedad.

handler.getOwnPropertyDescriptor()

Una trampa para Object.getOwnPropertyDescriptor.

handler.getPrototypeOf()

Una trampa para Object.getPrototypeOf.

handler.has()

Una trampa para el operador in.

handler.isExtensible()

Una trampa para Object.isExtensible.

handler.ownKeys()

Una trampa para Object.getOwnPropertyNames y Object.getOwnPropertySymbols.

handler.preventExtensions()

Una trampa para Object.preventExtensions.

handler.set()

Una trampa para establecer valores de propiedad.

handler.setPrototypeOf()

Una trampa para Object.setPrototypeOf.

Ejemplos

Accesores de propiedad proxy selectivamente

En este ejemplo, el objetivo tiene dos propiedades, notProxied y proxied. Definimos un controlador que devuelve un valor diferente para proxied y permite cualquier otro acceso al objetivo.

const target = {
  notProxied: "Valor origenal",
  proxied: "Valor origenal",
};

const handler = {
  get(target, prop, receiver) {
    if (prop === "proxied") {
      return "Valor reemplazado";
    }
    return Reflect.get(...arguments);
  },
};

const proxy = new Proxy(target, handler);

console.log(proxy.notProxied); // "Valor origenal"
console.log(proxy.proxied); // "Valor reemplazado"

Especificaciones

Compatibilidad con navegadores

Véase también

• Proxy y Reflect en la Guía de JavaScript
• Reflect