getPropertyDescriptor

getPropertyDescriptor.js

function getPropertyDescriptor(obj, key, path) {
  path = path || [];
  path.push(obj);
  if (obj.hasOwnProperty(key)) {
    var descriptor = Object.getOwnPropertyDescriptor(obj, key);
    descriptor.path = path;
    descriptor.owner = obj;
    return descriptor;
  } else if (key in obj){
    return getPropertyDescriptor(obj.__proto__, key, path);
  } else {
    throw new Error('key: ' + key + ' is not in object');
  }
}

// # usage
// 
// getPropertyDescriptor(document, 'addEventListener');
// =>
// {
//   configurable: true,
//   enumerable: true,
//   owner: EventTarget,
//   path: [document, HTMLDocument, Document, Node, EventTarget],
//   value: addEventListener(),
//   writable: true
// }