Proxy 是 JavaScript 中用于创建代理对象的构造函数,通过 target 和 handler 拦截并自定义对象操作;支持 get、set、has 等 trap 实现响应式、验证等功能;需配合 Reflect 安全转发,注意仅代理第一层、不可代理原始值等限制。
Proxy 是 JavaScript 中用于创建代理对象的构造函数,能拦截并自定义对目标对象的基本操作,比如读取、赋值、删除、调用等。
它不是修改原对象行为的“补丁”,而是包裹一层可编程的中间层,让开发者在不侵入原始逻辑的前提下,实现响应式系统、数据验证、日志记录、访问控制等功能。
Proxy 的基本结构:target + handler
创建 Proxy 需要两个参数:
target
:被代理的原始对象(可以是普通对象、数组、函数,甚至 null);
handler
:一个配置对象,里面定义各种“陷阱”(trap),即要拦截的操作及其处理逻辑。
示例:拦截属性读取和设置
const obj = { count: 0 };constproxy= new Proxy(obj, {get(target, prop) {console.log(`读取 ${prop}`);return target[prop];},set(target, prop, value) {console.log(`设置 ${prop} = ${value}`);target[prop] = value;return true; // 必须返回 true 表示赋值成功}});proxy.count++; // 输出:读取 count → 设置 count = 1
常用拦截操作(trap)及典型用途
以下是最常使用的几个 trap,每个都对应一种对象操作:
立即学习
“
Java免费学习笔记(深入)
”;
Eclipse导入Android或其他的JAVA项目的正确方法 WORD版
本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法;希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
下载
get(target, prop, receiver)
:拦截读取属性,可用于响应式依赖收集、默认值兜底(如
的轻量替代);
set(target, prop, value, receiver)
:拦截赋值,适合做类型校验、只读限制、变更通知(如 Vue 2 的 defineProperty 替代方案);
has(target, prop)
:拦截
操作符,可隐藏属性或模拟稀疏数组;
deleteProperty(target, prop)
:拦截
,实现不可删除属性;
apply(target, thisArg, args)
:仅对函数生效,拦截函数调用,可用于日志、节流、参数预处理;
construct(target, args, newTarget)
:拦截
调用,可控制实例化过程或返回不同对象。
注意边界与常见陷阱
Proxy 强大但有使用限制,忽略这些容易出错:
Proxy 只代理第一层——深层嵌套对象不会自动被拦截,需递归代理或结合 Reflect 使用;
不能代理非对象(如原始值 string/number),但可代理包装对象(
);
某些操作必须返回特定值才能成功,例如
必须返回
,
必须返回布尔值;
避免在 handler 中直接读写 target 的同名属性,否则可能触发无限递归(应通过
/
安全转发);
Proxy 对象不等于原对象:
为
,且
也不成立。
配合 Reflect 实现安全转发
Reflect 提供了一组与 trap 同名的静态方法,语义清晰、行为标准,推荐在 handler 中搭配使用:
const proxy = new Proxy({ x: 1 }, {get(target, prop, receiver) {console.log(`访问 ${prop}`);return Reflect.get(target, prop, receiver); // 安全转发},set(target, prop, value, receiver) {console.log(`设置 ${prop}`);return Reflect.set(target, prop, value, receiver); // 返回 boolean}});
这样既保留原始行为,又便于扩展逻辑,也避免了 this 绑定或原型链查找的手动处理。
obj?.x || 'default'indelete obj.propnewnew String('a')settruehasReflect.get()Reflect.set()proxy === objfalseObject.is(proxy, obj)