`handler.getOwnPropertyDescriptor()` 方法是 `Object.getOwnPropertyDescriptor()` 的陷阱。

## 语法

    var p = new Proxy(target, {
      getOwnPropertyDescriptor: function(target, prop) {
      }
    });

### 参数

`下列参数会被传入 getOwnPropertyDescriptor` 方法中。这是绑定到处理程序。

`target`
  目标对象。
`prop`
  返回属性名称的描述。

### 返回值

`getOwnPropertyDescriptor` 方法必须返回一个 object 或 u`ndefined。`

## 描述

`handler.getOwnPropertyDescriptor()` 方法是 `Object.getOwnPropertyDescriptor()` 的陷阱。

### 拦截

这个陷阱可以拦截这些操作：

- `Object.getOwnPropertyDescriptor()`
- `Reflect.getOwnPropertyDescriptor()`

### 不变量

如果下列不变量被违反，代理将抛出一个 `TypeError`：

- `getOwnPropertyDescriptor` 必须返回一个 object 或 u`ndefined。`
- 如果属性作为目标对象的不可配置的属性存在，则该属性无法报告为不存在。
- 如果属性作为目标对象的属性存在，并且目标对象不可扩展，则该属性无法报告为不存在。
- 如果属性不存在作为目标对象的属性，并且目标对象不可扩展，则不能将其报告为存在。
- 属性不能被报告为不可配置，如果它不作为目标对象的自身属性存在，或者作为目标对象的可配置的属性存在。
- Object.getOwnPropertyDescriptor（target）的结果可以使用 Object.defineProperty 应用于目标对象，也不会抛出异常。

## 示例

以下是 `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

以下代码则违反了不变量。

    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

## 规范

Specification | Status | Comment
--- | --- | ---
ECMAScript 2015 (6th Edition, ECMA-262) [[GetOwnProperty]] | Standard | Initial definition.
ECMAScript Latest Draft (ECMA-262) [[GetOwnProperty]] | Draft |

## 浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

- Desktop
- Mobile

Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari
--- | --- | --- | --- | --- | ---
Basic support | ? | 18 (18) | ? | ? | ?

Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile
--- | --- | --- | --- | --- | --- | ---
Basic support | ? | ? | 18.0 (18) | ? | ? | ?

## 相关链接

- `Proxy`
- `handler`
- `Object.getOwnPropertyDescriptor()`
- `Reflect.getOwnPropertyDescriptor()`