Reflect.getOwnPropertyDescriptor()

¥Syntax

Reflect.getOwnPropertyDescriptor(target, propertyKey)

¥Parameters

target

要在其中查找属性的目标对象。

propertyKey

要为其获取自己的属性描述符的属性的名称。

¥Return value

如果该属性作为 target 的自有属性存在，则为属性描述符对象；否则，undefined。

¥A property descriptor object if the property exists as an own property of target; otherwise, undefined.

¥Exceptions

TypeError

如果 target 不是对象，则抛出该异常。

¥Description

Reflect.getOwnPropertyDescriptor() 提供检索对象属性描述符的反射语义。与 Object.getOwnPropertyDescriptor() 的唯一区别是非对象目标的处理方式。如果目标不是对象，则 Reflect.getOwnPropertyDescriptor() 抛出 TypeError，而 Object.getOwnPropertyDescriptor() 将其强制为对象。

¥Reflect.getOwnPropertyDescriptor() provides the reflective semantic of retrieving the property descriptor of an object. The only difference with Object.getOwnPropertyDescriptor() is how non-object targets are handled. Reflect.getOwnPropertyDescriptor() throws a TypeError if the target is not an object, while Object.getOwnPropertyDescriptor() coerces it to an object.

Reflect.getOwnPropertyDescriptor() 调用 target 的 [[GetOwnProperty]] 对象内部方法。

¥Reflect.getOwnPropertyDescriptor() invokes the [[GetOwnProperty]] object internal method of target.

¥Examples

¥Using Reflect.getOwnPropertyDescriptor()

Reflect.getOwnPropertyDescriptor({ x: "hello" }, "x");
// {value: "hello", writable: true, enumerable: true, configurable: true}

Reflect.getOwnPropertyDescriptor({ x: "hello" }, "y");
// undefined

Reflect.getOwnPropertyDescriptor([], "length");
// {value: 0, writable: true, enumerable: false, configurable: false}

¥Difference with Object.getOwnPropertyDescriptor()

如果此方法的 target 参数不是对象（基元），那么它将导致 TypeError。对于 Object.getOwnPropertyDescriptor，非对象第一个参数将首先被强制为对象。

¥If the target argument to this method is not an object (a primitive), then it will cause a TypeError. With Object.getOwnPropertyDescriptor, a non-object first argument will be coerced to an object at first.

Reflect.getOwnPropertyDescriptor("foo", 0);
// TypeError: "foo" is not non-null object

Object.getOwnPropertyDescriptor("foo", 0);
// { value: "f", writable: false, enumerable: true, configurable: false }

¥See also

• core-js 中 Reflect.getOwnPropertyDescriptor 的 Polyfill
• Reflect
• Object.getOwnPropertyDescriptor()
• handler.getOwnPropertyDescriptor()