Proxy 是一个可编程的代理层,通过拦截对目标对象的所有访问行为(如读、写、枚举、构造等)实现逻辑注入,不修改原对象也不复制属性,但必须用 Proxy 实例替代原对象使用。

Proxy 是什么:一个可编程的代理层
Proxy 不是修饰器,也不是继承机制,它是在目标对象外加一层拦截逻辑——所有对目标对象的访问(读、写、枚举、构造……)都必须经过这个代理。它不修改原对象,也不复制属性,而是把操作“转发”出去,并允许你在转发前后插入自定义逻辑。
关键点在于:Proxy 实例本身不是原对象,你必须用它来替代原对象使用;一旦绕过 Proxy 直接操作原始对象,所有拦截就失效了。
怎么创建一个基础 Proxy:handler 里写 trap
Proxy 构造函数接收两个参数:target(要代理的对象)和 handler(包含各种拦截方法的对象,也叫 trap)。最常用的 trap 是 get 和 set:
const obj = { count: 0 };
const proxy = new Proxy(obj, {
get(target, key) {
console.log(`读取 ${key}`);
return target[key];
},
set(target, key, value) {
console.log(`设置 ${key} = ${value}`);
target[key] = value;
return true; // 必须返回 true 表示赋值成功
}
});
注意:set trap 必须显式返回 true,否则赋值会静默失败(严格模式下直接报 TypeError)。
立即学习“Java免费学习笔记(深入)”;
-
get中若未返回值,默认返回undefined,容易掩盖属性不存在的问题 -
has拦截in操作符,ownKeys拦截Object.getOwnPropertyNames和for...in的键获取 - 想让
proxy instanceof SomeClass正常工作?得用constructtrap 配合new.target
常见踩坑:this 指向、数组 length、原型链断裂
Proxy 代理的是“访问行为”,不是“对象身份”。这意味着:
- 方法内部的
this仍指向原对象(target),不是proxy;如果需要绑定到 proxy,得在get中手动.bind(proxy) - 对数组调用
push、pop等方法时,length属性更新不会触发settrap(因为这些方法内部直接改target.length),需额外监听length或用defineProperty封装 -
proxy.__proto__返回的是target.__proto__,但Object.getPrototypeOf(proxy)返回的是target的原型——看似一致,实际proxy没有自身的__proto__属性,属于“非扩展对象”的语义陷阱
不能拦截的操作:哪些行为天然逃逸
Proxy 并非万能。以下操作**完全无法拦截**,且不会触发任何 trap:
-
Object.getOwnPropertyDescriptor(proxy, 'x')→ 返回的是target上的描述符,与getOwnPropertyDescriptortrap 无关(除非你显式定义该 trap) -
proxy === target→ 永远为false,Proxy 实例和原对象内存地址不同 - 直接访问原型上的方法,如
proxy.toString()→ 走的是target.toString(),除非你重写了get并处理toString键 -
Reflect.ownKeys(proxy)会走ownKeystrap,但JSON.stringify(proxy)内部调用的是getOwnPropertyNames+getPrototypeOf,行为依赖多个 trap 协同
真正难调试的,往往是那些你以为被拦住了、其实根本没进 trap 的操作——比如忘了配 has 导致 key in proxy 返回 false,而 proxy[key] 又能取到值。











