proxy 拦截 getownpropertydescriptor 的唯一正统方式是定义 handler.getownpropertydescriptor；它需返回合法描述符或 undefined，且须与 ownkeys 配合控制属性可见性，否则隐藏属性仍可能被枚举到。
Proxy 本身不能直接拦截 getOwnPropertyDescriptor，但可以通过 ownKeys + getOwnPropertyDescriptor 配合实现“模拟拦截”——真正能被 Proxy 拦截的是 getOwnPropertyDescriptor 的调用入口，得靠 handler.getOwnPropertyDescriptor。
必须定义 handler.getOwnPropertyDescriptor 才能拦截
这是唯一正统方式。只要 Proxy 的 handler 中提供了 getOwnPropertyDescriptor 方法，所有对目标对象调用 Object.getOwnPropertyDescriptor(proxy, key) 的行为都会进入该方法，无论 key 是否真实存在。
- 返回值必须是对象（合法描述符）或
undefined；返回null或其他值会抛错 - 若返回描述符，其
value、writable、enumerable、configurable等字段需符合规范（例如不可同时设writable: false和value可变） - 若想让某个属性“看起来不存在”，可返回
undefined（注意：这不等于属性被删除，只是描述符查不到）
和 ownKeys 的配合很关键
getOwnPropertyDescriptor 只在明确查询某 key 时触发；但若想控制“哪些 key 能被枚举到”，必须同时实现 ownKeys。否则即使你用 getOwnPropertyDescriptor 隐藏了某个属性，它仍可能出现在 Object.keys() 或 for...in 中。
-
ownKeys决定Reflect.ownKeys()、Object.getOwnPropertyNames()、Object.getOwnPropertySymbols()返回哪些 key -
getOwnPropertyDescriptor决定对每个 key 调用Object.getOwnPropertyDescriptor()时返回什么 - 二者配合才能完整控制属性可见性与元信息
常见使用场景示例
比如隐藏内部属性 _secret，不让外部获取其描述符：
const target = { name: 'Alice', _secret: 42 };
const proxy = new Proxy(target, {
getOwnPropertyDescriptor(trapTarget, prop) {
if (prop === '_secret') return undefined; // 完全隐藏
return Reflect.getOwnPropertyDescriptor(trapTarget, prop);
},
ownKeys() {
return ['name']; // 不返回 _secret，避免被枚举到
}
});
Object.getOwnPropertyDescriptor(proxy, '_secret'); // undefined
Object.getOwnPropertyDescriptor(proxy, 'name'); // { value: 'Alice', writable: true, enumerable: true, configurable: true }
Object.keys(proxy); // ['name']
注意不可绕过的限制
某些操作无法被完全屏蔽，属于语言底层约束：
- 如果目标对象中某个属性是
configurable: false，你在getOwnPropertyDescriptor中返回的描述符也必须保持configurable: false，否则报错 - 不能通过 Proxy 让一个原本存在的属性“变成不可配置却可修改”，必须与目标一致或更严格
-
Object.defineProperty(proxy, ...)会走defineProperty拦截，与getOwnPropertyDescriptor无关，需单独处理
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
