Proxy 和 Reflect 是 JavaScript 元编程核心基础设施,Proxy 拦截对象基本操作(如 get/set/has),Reflect 提供对应可编程方法以确保语义一致性与边界兼容。

JavaScript 的 Proxy 和 Reflect 是元编程的基础设施,不是语法糖,也不是可有可无的装饰——它们让你在运行时拦截并自定义对象的基本行为。没有它们,就无法真正实现属性访问控制、响应式系统、透明代理、方法调用日志等底层能力。
Proxy 是什么?它拦截的是哪些操作?
Proxy 是一个构造函数,用来创建一个“代理对象”,该对象可以拦截对目标对象的特定操作(称为“trap”)。它不修改原对象,而是提供一层可编程的中间层。
常见可拦截的操作包括:get、set、has、deleteProperty、apply、construct、ownKeys 等。每种 trap 对应 JavaScript 引擎内部的一个基本操作。
-
get拦截读取属性(如obj.x或obj['x']),包括原型链查找 -
set拦截赋值(如obj.x = 1),但仅当属性可写且非严格模式下才触发 -
has拦截in运算符(如'x' in obj) -
ownKeys拦截Object.getOwnPropertyNames、Object.keys、for...in等枚举行为
注意:Proxy 无法代理普通函数的 length、name 等不可配置属性;也不能代理 eval、with 或全局变量访问(如直接写 x = 1)。
立即学习“Java免费学习笔记(深入)”;
Reflect 是什么?为什么不能只用 Proxy?
Reflect 是一个内置的、不可构造的对象,提供了一组静态方法,每个方法都与 Proxy 的 trap 同名且参数一致。它的核心作用是:把原本散落在 Object、Function 或操作符中的底层操作,统一为可调用的函数。
比如:obj[key] = val 是语法操作,没法被封装或条件执行;而 Reflect.set(obj, key, val) 是函数调用,可以传参、返回布尔值、被重写或包装。
-
Reflect.get(target, prop, receiver)—— 等价于target[prop],但显式支持receiver(用于正确绑定this) -
Reflect.set(target, prop, value, receiver)—— 返回布尔值表示是否成功,比=更可控 -
Reflect.construct(target, args)—— 替代new target(...args),便于拦截构造过程 -
Reflect.apply(target, thisArg, args)—— 显式调用函数,避免隐式this绑定问题
关键点:Reflect 方法默认行为和 JavaScript 引擎内部操作完全一致,因此在 Proxy handler 中推荐优先使用 Reflect.xxx 而非硬编码逻辑,否则容易漏掉边界情况(比如 set 里忘了检查 receiver)。
一个真实可用的响应式 proxy 示例
下面是一个极简但可运行的响应式 getter/setter 代理,演示 Proxy + Reflect 如何协作:
const handlers = {
get(target, prop, receiver) {
console.log(`[GET] ${String(prop)}`);
return Reflect.get(target, prop, receiver);
},
set(target, prop, value, receiver) {
console.log(`[SET] ${String(prop)} =`, value);
const result = Reflect.set(target, prop, value, receiver);
if (result && prop === 'count') {
console.log('→ 触发副作用:更新视图');
}
return result;
}
};
const data = { count: 0 };
const reactive = new Proxy(data, handlers);
reactive.count = 5; // 输出 [SET] count = 5 → 触发副作用:更新视图
console.log(reactive.count); // 输出 [GET] count,然后 5
这个例子看似简单,但已经体现了元编程的本质:你没有改 data,却让每次读写都带上可编程的逻辑。实际框架(如 Vue 3)在此基础上增加了依赖收集、触发更新、嵌套代理等机制,但起点就是这个 get/set 拦截。
容易踩的坑和限制
Proxy 和 Reflect 不是银弹。几个高频翻车点:
- Proxy 只能代理对象(包括数组、函数、RegExp 等),不能代理原始值(
string、number、boolean)——想代理字符串得先包装成new String('x') - 代理对象和原对象是分离的:修改代理不会自动同步到原对象的引用位置(除非你始终只用代理)
- Proxy 无法拦截
for...of、Array.prototype.forEach等迭代方法,需配合Symbol.iteratortrap 或重写方法 -
Reflect.setPrototypeOf在严格模式下失败会抛错,而Object.setPrototypeOf可能静默失败,这点要留意 - Chrome DevTools 里 Proxy 默认显示为
Proxy { … },看不到内部 target,调试时建议加toStringTag或用console.dir(proxy, { depth: null })
真正难的不是写一个 Proxy,而是判断某个行为是否可被拦截、是否需要 fallback 到 Reflect、以及如何保持语义一致性——比如 set 返回 false 时,引擎会拒绝赋值,但你的业务逻辑是否已为此做好准备?











