proxy 的 getownpropertydescriptor 拦截器用于拦截获取属性描述符操作，接收代理对象、属性名和 receiver 三个参数，必须返回合法描述符或 undefined，常用于权限控制与属性隐藏。
可以使用 Proxy 的 getOwnPropertyDescriptor 拦截器来拦截对目标对象属性描述符的获取操作，比如调用 Object.getOwnPropertyDescriptor() 或进行 for...in 遍历时的内部查询。
理解 getOwnPropertyDescriptor 拦截器
该拦截器在访问对象某个属性的描述符（descriptor）时触发，接收三个参数：代理对象、属性名、receiver（通常为代理本身）。它必须返回一个对象或 undefined；若返回非对象值（如字符串、null），会抛出 TypeError。
- 返回的对象需符合属性描述符规范（如包含
value/get、writable、enumerable、configurable等字段） - 若返回
undefined，表示该属性在代理中“不存在”，即使目标对象中有该属性 - 若目标属性不可配置（
configurable: false），而你返回的 descriptor 中configurable为true，也会报错
基础用法示例
下面是一个简单代理，隐藏私有属性 _secret 的描述符：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
const target = {
name: 'Alice',
_secret: 'password123'
};
const handler = {
getOwnPropertyDescriptor(target, prop) {
if (prop === '_secret') {
return undefined; // 让 _secret 看起来不存在
}
return Object.getOwnPropertyDescriptor(target, prop);
}
};
const proxy = new Proxy(target, handler);
console.log(Object.getOwnPropertyDescriptor(proxy, 'name'));
// { value: 'Alice', writable: true, enumerable: true, configurable: true }
console.log(Object.getOwnPropertyDescriptor(proxy, '_secret'));
// undefined
配合 defineProperty 和 ownKeys 实现一致行为
单独拦截 getOwnPropertyDescriptor 可能导致行为不一致。例如，若你在 ownKeys 中过滤掉某个属性，但 getOwnPropertyDescriptor 仍返回其描述符，就可能违反 JavaScript 的内部约束。建议协同处理：
- 在
ownKeys中隐藏属性 → 同时在getOwnPropertyDescriptor中返回undefined - 若重写
defineProperty，也要确保新 descriptor 能被getOwnPropertyDescriptor正确返回 - 注意：如果目标属性是不可配置的，代理不能改变其
configurable或enumerable值
常见用途与注意事项
这个拦截器常用于权限控制、调试代理、模拟不可枚举属性或实现虚拟属性。
- 可用于屏蔽敏感字段的元信息，防止通过
getOwnPropertyDescriptor或Object.keys()（后者依赖ownKeys）暴露 - 不能拦截
Object.prototype.propertyIsEnumerable—— 它依赖getOwnPropertyDescriptor的返回结果中的enumerable字段，所以需确保 descriptor 中该字段准确 - 若代理目标是数组，拦截
length的 descriptor 需特别小心，避免破坏数组长度机制
