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 多用于框架底层,业务代码极少直接写。
立即学习“Java免费学习笔记(深入)”;
使用场景差异明显: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()同时使用时,settrap 仍会被触发,但Reflect.set()会返回false,需手动检查并 throw
真正难的不是写出第一个 Proxy,而是想清楚哪些操作需要拦截、哪些不该拦、以及如何在不破坏语义的前提下做副作用——比如响应式系统里,get 必须收集依赖,set 必须触发更新,但又不能让开发者感知到代理的存在。











