Proxy 是对目标对象的可编程拦截层,解决访问控制问题,如响应式、权限校验、日志等;必须传入对象 target 和 handler 对象,常用 get/set trap 需配合 Reflect 方法确保正确转发。

Proxy 是什么,它解决什么问题
Proxy 不是普通对象,而是对另一个对象的“拦截层”——你操作的是 Proxy 实例,但实际行为由你定义的 handler 控制。它不修改原对象,也不替代原对象,而是提供一层可编程的访问控制。常见用途包括:数据响应式(如 Vue 3)、权限校验、日志记录、不可变封装、属性访问兜底(类似 get 中返回默认值)。
必须传两个参数:target 和 handler
创建 Proxy 的语法固定为 new Proxy(target, handler)。漏掉任一参数都会报错:TypeError: Cannot create proxy with a non-object as target or handler。注意:target 必须是对象(含数组、函数、RegExp 等),null 或原始值(如 42、"str")直接报错;handler 可以是空对象 {},此时 Proxy 表现和原对象一致,但已具备扩展能力。
常见错误场景:
- 把
handler写成function而非对象 - 误将字符串或数字直接传给
target,没包装成对象 - 在
handler中忘记return Reflect.get(...)等默认转发,导致读取属性返回undefined
get 和 set 是最常用且易出错的 trap
get(target, prop, receiver) 拦截属性读取;set(target, prop, value, receiver) 拦截赋值。关键点在于:它们不会自动执行原操作,必须显式调用 Reflect.get 或 Reflect.set(推荐)来触发默认行为,否则会静默失效。
立即学习“Java免费学习笔记(深入)”;
在整本书中我们所涉及许多的Flex框架源码,但为了简洁,我们不总是显示所指的代码。当你阅读这本书时,要求你打开Flex Builder,或能够访问Flex3框架的源码,跟随着我们所讨论源码是怎么工作及为什么这样做。 如果你跟着阅读源码,请注意,我们经常跳过功能或者具体的代码,以便我们可以对应当前的主题。这样能防止我们远离当前的主题,主要是讲解代码的微妙之处。这并不是说那些代码的作用不重要,而是那些代码处理特别的案例,防止潜在的错误或在生命周期的后面来处理,只是我们当前没有讨论它。有需要的朋友可以下载看看
const obj = { count: 0 };
const p = new Proxy(obj, {
get(target, prop) {
console.log(`读取 ${prop}`);
return target[prop]; // ❌ 不推荐:绕过原型链、不支持 this 绑定
// ✅ 推荐:return Reflect.get(target, prop, p);
},
set(target, prop, value) {
if (prop === 'count' && typeof value !== 'number') {
throw new Error('count 必须是数字');
}
target[prop] = value; // ❌ 风险:跳过 setter、忽略原型上同名 setter
// ✅ 推荐:return Reflect.set(target, prop, value, p);
}
});
遗漏 receiver 参数会导致 this 指向错误,尤其在访问 getter/setter 时;用 Reflect 方法能自动透传 receiver,避免这类 bug。
Proxy 无法代理非对象,也不能劫持已有属性的 descriptor
Proxy 只能代理对象本身,对它的属性是否可枚举、是否可配置等元信息(即 Object.getOwnPropertyDescriptor 返回的内容)无感知,也无法动态修改这些 descriptor。想监听属性定义(如 Object.defineProperty)需用 defineProperty trap;想拦截 in 操作符用 has;想让 for...in 只遍历特定属性,得配合 ownKeys + getOwnPropertyDescriptor trap。
真正容易被忽略的一点:Proxy 创建后,原对象仍可被直接访问。若业务逻辑同时混用 obj 和 p,响应式或校验就会失效——你得确保所有访问都走 Proxy 实例,且不要意外暴露 target。








