Proxy 是用于完全接管对象底层操作的拦截机制,而非装饰器;可拦截 get/set/has/deleteProperty/ownKeys/construct 等操作,但不支持私有字段和原始值代理,且需正确传递 receiver 参数以保障原型链语义。

JavaScript 的 Proxy 对象不是用来“增强对象功能”的装饰器,而是用来**完全接管对象底层操作行为**的底层控制机制。它不修改原对象,也不替代继承或 class,而是通过一层拦截层,让读写、枚举、构造等动作全部可控。
哪些基本操作能被 Proxy 拦截
不是所有属性访问都会触发 Proxy,只有明确落入其 trap(陷阱)覆盖范围的操作才会被拦截。常见可拦截行为包括:
-
get:读取属性(obj.x、obj['x'])、原型链查找(若没找到会继续查原型) -
set:赋值(obj.x = 1),但仅对**可写自有属性**生效;冻结对象或 setter 属性会绕过或报错 -
has:in操作符('x' in obj) -
deleteProperty:delete obj.x -
ownKeys:Object.getOwnPropertyNames()、Object.keys()、for...in等枚举行为 -
defineProperty和getOwnPropertyDescriptor:影响属性定义与描述符读取 -
construct:仅对函数对象生效,拦截new ProxyTarget(...)
注意:Proxy 无法拦截点运算符本身,它拦截的是“读取这个键名”这件事;也不能拦截私有字段 #x —— 访问私有字段会直接报 TypeError: Cannot read private field,根本不会走到 get。
get 和 set 中的 receiver 参数容易被忽略
这两个 trap 的第 3 个参数 receiver 是当前操作的原始调用目标(通常是 proxy 本身,但在原型链访问时可能是子对象)。它决定了 this 绑定和 getter 执行上下文。漏掉它会导致:
立即学习“Java免费学习笔记(深入)”;
- 代理对象上的 getter 方法内部
this指向错误(变成原对象而非 proxy) - 使用
Reflect.get(target, key, receiver)时不传receiver,将丢失原型链访问语义
正确写法必须显式透传:
const p = new Proxy({ x: 1 }, {
get(target, key, receiver) {
console.log('accessed:', key);
return Reflect.get(target, key, receiver); // ✅ 必须传 receiver
},
set(target, key, value, receiver) {
console.log('setting:', key, value);
return Reflect.set(target, key, value, receiver); // ✅ 同样要传
}
});
否则在 class 继承或 Object.create() 场景下,get 返回值可能意外为 undefined,或 setter 不触发。
不能代理非对象类型,且 Proxy 实例不可被 instanceof 正确识别
Proxy 只接受对象(含函数、数组、正则等对象包装类型)作为 target;传入原始值如 42、'abc' 会抛出 TypeError: Cannot create proxy with a non-object as target or handler。
更隐蔽的问题是:instanceof 检查对 Proxy 失效:
const target = {};
const p = new Proxy(target, {});
console.log(p instanceof Object); // false ❌
console.log(p.constructor === Object); // false ❌
这是因为 Proxy 的 [[GetPrototypeOf]] 行为默认返回 target 的原型,但 instanceof 内部使用的是 Symbol.hasInstance,而该方法不会被 Proxy 自动转发。若需兼容,得手动在 handler 中实现 get 对 constructor 和 [Symbol.hasInstance] 的处理,但通常不推荐——这已超出 Proxy 的设计边界。
真正难的是把 ownKeys + getOwnPropertyDescriptor + has 配合好,才能让 for...in、Object.keys()、in 三者行为一致;稍有疏漏,就会出现“属性明明存在却遍历不到”或者“in 返回 true 但 obj[key] 是 undefined”的情况。











