handler.getOwnPropertyDescriptor()

El método getOwnPropertyDescriptor recibe los siguiente parámetros. this está asociado al handler del proxy.

target

El objeto destino.

prop

El nombre de la propiedad cuya descripción ha de ser devuelta.

El método getOwnPropertyDescriptor debe devolver un objeto o undefined.

El método handler.getOwnPropertyDescriptor() captura Object.getOwnPropertyDescriptor().

Este método intercepta las siguientes operaciones:

• Object.getOwnPropertyDescriptor()
• Reflect.getOwnPropertyDescriptor() (en-US)

Si los siguientes invariantes son violados, el proxy lanzará TypeError:

• getOwnPropertyDescriptor debe devolver un objeto o undefined.
• No puede devolver que una propiedad no existe si está presente en el objeto como no configurable.
• No puede devolver que una propiedad no existe si esta está presente como una propiedad propia del objeto destino y el objeto no es extensible.
• No puede devolver que una propuedad existe, si esta no está presente en el objeto destino y el objeto no es extensible.
• No puede devolver que una propiedad es no configurable si esta no existe en el objeto destino o si existe pero sí es configurable.
• El resultado de Object.getOwnPropertyDescriptor(target) puede ser aplicado al objeto destino mediante Object.defineProperty y no lanzará ningún tipo de excepción.

El siguiente código captura Object.getOwnPropertyDescriptor().

var p = new Proxy({ a: 20}, {
  getOwnPropertyDescriptor: function(target, prop) {
    console.log('called: ' + prop);
    return { configurable: true, enumerable: true, value: 10 };
  }
});

console.log(Object.getOwnPropertyDescriptor(p, 'a').value); // "called: a"
                                                            // 10

El siguiente código viola uno de los invariantes definidos previamente.

var obj = { a: 10 };
Object.preventExtensions(obj);
var p = new Proxy(obj, {
  getOwnPropertyDescriptor: function(target, prop) {
    return undefined;
  }
});

Object.getOwnPropertyDescriptor(p, 'a'); // TypeError is thrown

• Proxy
• handler
• Object.getOwnPropertyDescriptor()
• Reflect.getOwnPropertyDescriptor() (en-US)