Proxy是拦截对象操作的构造函数,Reflect提供与之对应的标准化方法;二者协作可规范拦截逻辑、复用默认行为并支持receiver等细节。

JavaScript 中的代理(Proxy)和反射(Reflect)是一对协作机制:Proxy 用来拦截对象操作,Reflect 提供一套与 Proxy 拦截器对应的标准方法,让拦截逻辑更规范、更可复用。
Proxy 是什么?如何创建并拦截操作
Proxy 是一个构造函数,接收目标对象和一个“处理器”(handler)对象,返回一个代理对象。对代理对象的任何操作(如读取属性、赋值、调用方法等),都会先经过 handler 中定义的对应陷阱(trap)函数。
常见拦截操作包括:
-
get(target, prop, receiver):拦截属性读取,例如
obj.name -
set(target, prop, value, receiver):拦截属性赋值,例如
obj.age = 30 -
has(target, prop):拦截
prop in obj -
deleteProperty(target, prop):拦截
delete obj.prop - apply(target, thisArg, args):拦截函数调用,适用于代理函数
-
construct(target, args, newTarget):拦截
new调用
示例:限制只读属性访问
立即学习“Java免费学习笔记(深入)”;
const obj = { x: 1 };const proxy = new Proxy(obj, {
get(target, prop) {
if (prop === 'secret') throw new Error('禁止访问');
return target[prop];
}
});
proxy.x // → 1
proxy.secret // → 抛出错误
Reflect 是什么?为什么需要它
Reflect 是一个内置对象,提供静态方法,其命名和参数与 Proxy 的 trap 完全一致(如 Reflect.get()、Reflect.set())。它的核心作用是:
- 把原本散落在 Object、Function 等上的底层操作统一标准化
- 在 Proxy handler 中替代直接操作 target,避免 this 绑定或原型链问题
- 让默认行为更明确、更可靠(比如正确处理 getter/setter、proxy 链、receiver 参数)
例如,在 set 拦截中,用 Reflect.set() 替代 target[prop] = value,能正确触发 setter 并返回布尔结果:
set(target, prop, value, receiver) {
// ✅ 推荐:语义清晰,支持 receiver 和 setter
return Reflect.set(target, prop, value, receiver);
// ❌ 不推荐:绕过 setter,忽略 receiver
// target[prop] = value;
// return true;
}
};
Proxy + Reflect 的典型配合模式
大多数实际场景中,Proxy 负责“拦截 + 增强/校验/记录”,Reflect 负责“执行原始操作”。这种组合既保持了行为一致性,又便于扩展逻辑。
例如:实现带日志的属性访问
const obj = { a: 1 };const loggedProxy = new Proxy(obj, {
get(target, prop, receiver) {
console.log(`读取 ${prop}`);
return Reflect.get(target, prop, receiver);
},
set(target, prop, value, receiver) {
console.log(`设置 ${prop} = ${value}`);
return Reflect.set(target, prop, value, receiver);
}
});
这样既不破坏原语义,又能注入可观测性逻辑。
注意事项和限制
Proxy 无法拦截所有操作,以下情况不受影响:
- 对象自有属性的存在性检测(
Object.prototype.hasOwnProperty.call(proxy, 'x')不走has) - 部分内部方法,如
[[GetPrototypeOf]]在非 extensible 对象上可能绕过getPrototypeOf - 代理只能拦截“对外暴露的操作”,不能捕获对象内部方法的私有访问(如类中 #private 字段的访问由引擎强制保护,Proxy 无权介入)
- 代理对象与原始对象是分离的;修改代理不会自动同步到原始对象之外的引用(除非你显式设计响应式逻辑)
另外,Proxy 一旦创建就不能取消(ES2023 新增 Proxy.revocable() 可解决此问题)。











