17370845950

Proxy 是一个用于创建可编程代理对象的构造函数，能拦截对目标对象的访问、赋值等操作，实现元编程；需正确使用 Reflect.get/set 并传入 receiver，避免原型链破坏或死循环。

Proxy 是什么：一个可编程的代理对象

Proxy 不是语法糖，也不是新数据类型，它是一个构造函数，用来创建一个“代理”——这个代理能拦截对目标对象的访问、赋值、枚举、函数调用等操作，并在这些操作发生前插入自定义逻辑。Proxy 的核心价值在于它让 JavaScript 第一次具备了真正意义上的“元编程”能力，即在运行时控制对象行为。

怎么用 Proxy 拦截 get/set：最常用也最容易出错的场景

绝大多数人第一次用 Proxy 就是为了做响应式（比如 Vue 3）或字段校验。关键不是写 new Proxy()，而是正确处理 get 和 set 的第三个参数 receiver，否则会破坏原型链或导致递归死循环。

常见错误现象：Maximum call stack size exceeded（无限递归）、undefined 返回值、this 指向丢失。

• 必须在 get 中使用 Reflect.get(target, key, receiver)，而不是直接 target[key]，否则访问原型方法时会跳过代理
• set 中必须返回布尔值：true 表示设置成功，false 表示失败（严格模式下会抛 TypeError）
• 如果目标属性是 getter/setter，set 里不能直接赋值给 target[key] = value，而要用 Reflect.set() 并传入 receiver

const obj = { a: 1 };
const proxy = new Proxy(obj, {
  get(target, key, receiver) {
    console.log('get', key);
    return Reflect.get(target, key, receiver);
  },
  set(target, key, value, receiver) {
    console.log('set', key, value);
    return Reflect.set(target, key, value, receiver);
  }
});
proxy.a = 2; // 输出 set a 2，然后正常赋值

哪些操作能被拦截：不只是 get/set

Proxy 支持 13 种 trap（拦截器），但实际项目中高频使用的只有几个：get、set、has（对应 in 操作符）、ownKeys（对应 Object.keys() 和 for...in）、deleteProperty、apply（拦截函数调用）。其余如 construct、defineProperty 多用于框架底层，业务代码极少直接写。

使用场景差异明显：has 可以让属性“看起来存在但读不到”，ownKeys 能隐藏某些属性不被遍历，apply 则适合包装函数执行前/后逻辑。

• has 返回 false 时，key in proxy 为 false，但不影响 proxy[key] 的读取（除非 get 也返回 undefined）
• ownKeys 必须返回数组，且必须包含所有不可配置（non-configurable）属性名，否则 Object.getOwnPropertyNames() 会报错
• 拦截函数调用必须用 apply(target, thisArg, argumentsList)，不能只写 get；thisArg 是调用时的 this，不是代理对象本身

Proxy 的边界和坑：不是万能的，也不能替代 Object.defineProperty

Proxy 无法代理原始值（string、number、boolean），也不能代理 undefined 或 null；它只能代理对象（包括数组、函数、Date、RegExp 等）。更重要的是：一旦对象被代理，就无法撤销（ECMAScript 提案 RevocableProxy 仍未进入标准）。

性能方面，每次属性访问都经过 trap，开销比普通对象高；V8 引擎对深度嵌套代理的优化有限，频繁触发 get/set 会影响渲染帧率。

• 数组索引赋值（arr[0] = x）会被 set 拦截，但 push、pop 等方法内部调用的是原型方法，需额外在 get 中拦截数组方法并包装
• Proxy 代理后的对象，instanceof 仍指向原构造函数，不会变成 Proxy 类型
• 与 Object.freeze() 同时使用时，set trap 仍会被触发，但 Reflect.set() 会返回 false，需手动检查并 throw

真正难的不是写出第一个 Proxy，而是想清楚哪些操作需要拦截、哪些不该拦、以及如何在不破坏语义的前提下做副作用——比如响应式系统里，get 必须收集依赖，set 必须触发更新，但又不能让开发者感知到代理的存在。