Proxy 是一个可编程的代理层,通过拦截对目标对象的所有访问行为(如读、写、枚举、构造等)实现逻辑注入,不修改原对象也不复制属性,但必须用 Proxy 实例替代原对象使用。
Proxy 不是修饰器,也不是继承机制,它是在目标对象外加一层拦截逻辑——所有对目标对象的访问(读、写、枚举、构造……)都必须经过这个代理。它不修改原对象,也不复制属性,而是把操作“转发”出去,并允许你在转发前后插入自定义逻辑。
关键点在于:Proxy 实例本身不是原对象,你必须用它来替代原对象使用;一旦绕过 Proxy 直接操作原始对象,所有拦截就失效了。
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)。
get 中若未返回值,默认返回 undefined,容易掩盖属性不存在的问题has 拦截 in 操作符,ownKeys 拦截 Object.getOwnPropertyNames 和 for...in 的键获取proxy instanceof SomeClass 正常工作?得用 construct trap 配合 new.target
Proxy 代理的是“访问行为”,不是“对象身份”。这意味着:
this 仍指向原对象(target),不是 proxy;如果需要绑定到 proxy,得在 get 中手动 .bind(proxy)
push、pop 等方法时,length 属性更新不会触发 set trap(因为这些方法内部直接改 target.length),需额外监听 length 或用 defineProperty 封装proxy.__proto__ 返回的是 target.__proto__,但 Object.getPrototypeOf(proxy) 返回的是 target 的原型——看似一致,实际 proxy 没有自身的 __proto__ 属性,属于“非扩展对象”的语义陷阱Proxy 并非万能。以下操作**完全无法拦截**,且不会触发任何 trap:
Object.getOwnPropertyDescriptor(proxy, 'x') → 返回的是 target 上的描述符,与 getOwnPropertyDescriptor trap 无关(除非你显式定义该 trap)proxy === target → 永远为 false,Proxy 实例和原对象内存地址不同proxy.toString() → 走的是 target.toString(),除非你重写了 get 并处理 toString 键Reflect.ownKeys(proxy) 会走 ownKeys trap,但 JSON.stringify(pr
oxy) 内部调用的是 getOwnPropertyNames + getPrototypeOf,行为依赖多个 trap 协同真正难调试的,往往是那些你以为被拦住了、其实根本没进 trap 的操作——比如忘了配 has 导致 key in proxy 返回 false,而 proxy[key] 又能取到值。