reflect.getownpropertydescriptor用于获取对象自有属性的完整描述符,返回包含value/writable/enumerable/configurable或get/set等字段的对象,属性不存在时返回undefined。

Reflect.getOwnPropertyDescriptor 用于获取对象某个属性的完整描述符(descriptor),返回一个包含 value、writable、enumerable、configurable 等字段的对象;如果属性不存在或不可访问,则返回 undefined。
基本用法:传入对象和属性名
语法很简单:Reflect.getOwnPropertyDescriptor(obj, propKey)。第一个参数是目标对象,第二个是属性名(字符串或 Symbol)。
- 适用于自有属性(own property),不查找原型链上的属性
- 返回值是 descriptor 对象或
undefined,不会抛错 - 比
Object.getOwnPropertyDescriptor更符合“反射”语义,且设计为可被 Proxy 拦截
查看数据属性描述符
对于普通赋值创建的属性,默认是可写、可枚举、可配置的:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
const obj = { name: 'Alice' };
console.log(Reflect.getOwnPropertyDescriptor(obj, 'name'));
// { value: 'Alice', writable: true, enumerable: true, configurable: true }
手动定义属性时,可以控制这些特性:
Object.defineProperty(obj, 'age', {
value: 30,
writable: false,
enumerable: false,
configurable: true
});
console.log(Reflect.getOwnPropertyDescriptor(obj, 'age'));
// { value: 30, writable: false, enumerable: false, configurable: true }
区分数据属性和访问器属性
如果属性是 getter/setter(访问器属性),返回的 descriptor 中不含 value 和 writable,而是包含 get 和 set:
const obj = {
_x: 100,
get x() { return this._x; },
set x(v) { this._x = v; }
};
console.log(Reflect.getOwnPropertyDescriptor(obj, 'x'));
// { get: ƒ, set: ƒ, enumerable: true, configurable: true }
注意:不能同时存在 value/writable 和 get/set,否则会报错(但 getOwnPropertyDescriptor 本身不校验,只如实返回已定义的内容)。
常见注意事项
- 只查自有属性 ——
Reflect.getOwnPropertyDescriptor({__proto__: {a: 1}}, 'a')返回undefined - 对不可扩展对象或冻结对象依然有效,只是返回的 descriptor 中
configurable可能为false - 对
undefined、null或原始值调用会抛TypeError,需先确保是对象 - Symbol 属性同样支持:
Reflect.getOwnPropertyDescriptor(obj, Symbol('key'))
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










