Reflect.getOwnPropertyDescriptor()
Reflect.getOwnPropertyDescriptor() 静态方法与 Object.getOwnPropertyDescriptor() 类似。如果给定属性存在于对象上，它将返回该属性的属性描述符；否则，返回 undefined。
试一试
const object = {
property1: 42,
};
console.log(Reflect.getOwnPropertyDescriptor(object, "property1").value);
// Expected output: 42
console.log(Reflect.getOwnPropertyDescriptor(object, "property2"));
// Expected output: undefined
console.log(Reflect.getOwnPropertyDescriptor(object, "property1").writable);
// Expected output: true
语法
js
Reflect.getOwnPropertyDescriptor(target, propertyKey)
参数
目标-
要在其中查找属性的目标对象。
propertyKey-
要获取自有属性描述符的属性名称。
返回值
如果属性作为 target 的自有属性存在，则返回一个属性描述符对象；否则，返回 undefined。
异常
TypeError-
如果
target不是一个对象，则抛出。
描述
Reflect.getOwnPropertyDescriptor() 提供了检索对象属性描述符的反射语义。与 Object.getOwnPropertyDescriptor() 的唯一区别在于如何处理非对象目标。如果目标不是对象，Reflect.getOwnPropertyDescriptor() 会抛出 TypeError，而 Object.getOwnPropertyDescriptor() 会将其强制转换为对象。
Reflect.getOwnPropertyDescriptor() 调用 target 的 [[GetOwnProperty]] 对象内部方法。
示例
使用 Reflect.getOwnPropertyDescriptor()
js
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}
与 Object.getOwnPropertyDescriptor() 的区别
如果此方法的 target 参数不是对象（而是原始值），则会引发 TypeError。使用 Object.getOwnPropertyDescriptor 时，非对象第一个参数首先会被强制转换为对象。
js
Reflect.getOwnPropertyDescriptor("foo", 0);
// TypeError: "foo" is not non-null object
Object.getOwnPropertyDescriptor("foo", 0);
// { value: "f", writable: false, enumerable: true, configurable: false }
规范
| 规范 |
|---|
| ECMAScript® 2026 语言规范 # sec-reflect.getownpropertydescriptor |
浏览器兼容性
加载中…