El constructorProxy() crea objetosProxy.

Sintaxis

new Proxy(target, handler)

Parameters

target

Un objeto de destino para envolver conProxy. 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 constructorProxy() para crear un nuevo objetoProxy.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 objetohandler, puede personalizar aspectos específicos del comportamiento del proxy. Por ejemplo, al definirget() puede proporcionar una versión personalizada delacceso 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 denominantrampas, 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 operadornew.

handler.defineProperty()

Una trampa paraObject.defineProperty.

handler.deleteProperty()

Una trampa para el operadordelete.

handler.get()

Una trampa para obtener valores de propiedad.

handler.getOwnPropertyDescriptor()

Una trampa paraObject.getOwnPropertyDescriptor.

handler.getPrototypeOf()

Una trampa paraObject.getPrototypeOf.

handler.has()

Una trampa para el operadorin.

handler.isExtensible()

Una trampa paraObject.isExtensible.

handler.ownKeys()

Una trampa paraObject.getOwnPropertyNames yObject.getOwnPropertySymbols.

handler.preventExtensions()

Una trampa paraObject.preventExtensions.

handler.set()

Una trampa para establecer valores de propiedad.

handler.setPrototypeOf()

Una trampa paraObject.setPrototypeOf.

Ejemplos

Accesores de propiedad proxy selectivamente

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

const target = {  notProxied: "Valor original",  proxied: "Valor original",};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 original"console.log(proxy.proxied); // "Valor reemplazado"

Especificaciones

Compatibilidad con navegadores

Véase también

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