Proxy 能拦截 get、set、has、deleteProperty、apply、construct 等 13 种内置操作;它不自动响应原始对象赋值,需通过 Proxy 实例访问才生效,且无法替代 Object.defineProperty 对属性描述符的细粒度控制。

Proxy 能拦截哪些操作?
Proxy 不是装饰器,也不是语法糖,它是一个能捕获并重定义基本操作的“代理层”。只要目标对象被 Proxy 包裹,所有对它的 get、set、has、deleteProperty、apply、construct 等 13 种内置操作,都可被拦截。比如你读取 obj.name,实际触发的是 handler.get(target, 'name', receiver),不是直接访问属性。
常见误用是以为 Proxy 能监听“属性变化”,其实它不自动响应赋值——必须通过 Proxy 实例访问对象才生效。直接改原始对象(target)绕过 Proxy,就什么也拦不到。
- 必须用
new Proxy(target, handler)创建新引用,原对象不变 -
receiver参数常被忽略,但它影响this绑定,尤其在访问 getter 或原型链时很关键 - 拦截函数调用要用
apply;拦截 new 调用要用construct,二者不可互换
用 Proxy 实现响应式数据(如简易 Vue reactive)
核心思路:把对象所有嵌套属性递归代理,并在 get 中收集依赖,在 set 中触发更新。但 Proxy 本身不递归——需要手动处理嵌套对象和数组。
注意:数组的 push、pop 等方法不会触发 set,而是触发 get(读取 length)或 ownKeys,所以得在 get 拦截里对数组方法做特殊处理,或重写数组原型方法。
立即学习“Java免费学习笔记(深入)”;
const handlers = {
get(target, prop, receiver) {
track(target, prop); // 收集依赖
const res = Reflect.get(target, prop, receiver);
// 对象/数组递归代理
return (typeof res === 'object' && res !== null)
? reactive(res)
: res;
},
set(target, prop, value, receiver) {
const oldVal = target[prop];
const res = Reflect.set(target, prop, value, receiver);
if (oldVal !== value) trigger(target, prop);
return res;
}
};
function reactive(obj) {
if (typeof obj !== 'object' || obj === null) return obj;
return new Proxy(obj, handlers);
}
Proxy 不能替代 Object.defineProperty 的地方
Proxy 是对整个对象的代理,而 Object.defineProperty 是对单个属性的精确控制。这意味着:
- Proxy 无法监听“新增属性”是否为
enumerable或writable——它只管操作,不管属性描述符 - 无法模拟
Object.freeze()的全部行为:freeze会让set失败并静默(非严格模式),但 Proxy 的set拦截必须显式返回false才报错,且错误类型是TypeError,不是冻结语义 - Proxy 无法拦截
for...in中的不可枚举属性过滤逻辑——那是ownKeys+getOwnPropertyDescriptor共同决定的,后者仍走原对象
换句话说:需要控制属性元信息(如 configurable)、兼容旧环境、或做细粒度 descriptor 操作时,Object.defineProperty 仍是不可替代的。
真实项目中 Proxy 的性能与边界
Proxy 创建开销小,但每次属性访问都多一层函数调用。高频读写场景(如 Canvas 动画帧内反复读取 position.x)会明显放大延迟。V8 引擎虽已优化 Proxy 调用路径,但依然比原生访问慢 2–5 倍。
更隐蔽的问题是内存泄漏:如果在 get 中持续新建函数(如返回绑定 this 的包装函数),又没清理引用,WeakMap 缓存失效,就会累积代理对象无法 GC。
- 避免在
get中返回新函数,优先复用或用闭包缓存 - 对大型对象(字段 > 100 个)慎用深层 reactive,考虑按需代理(lazy reactive)
- Node.js 环境下,Proxy 无法拦截
require、process.env等全局对象,因为它们是 C++ 层绑定,不在 JS 对象模型内
真正难的不是写一个 Proxy,而是判断该不该用、在哪一层用、以及怎么让它不拖慢整个数据流。











