Proxy 是 JavaScript 中用于创建代理对象的构造函数,可拦截并自定义对目标对象的基本操作;它通过 handler 中的 trap 方法(如 get、set)实现响应式、验证、日志等功能,依赖引擎底层支持,不递归代理嵌套对象。

Proxy 是 JavaScript 中用于创建代理对象的构造函数,它能拦截并自定义对目标对象的基本操作(如读取、赋值、枚举、函数调用等),从而实现响应式、数据验证、日志记录、访问控制等高级行为。
Proxy 的核心机制:拦截器(trap)
Proxy 接收两个参数:目标对象(target)和处理器对象(handler)。handler 中定义的方法叫“trap”,每个 trap 对应一种对象操作。当通过 Proxy 实例访问目标对象时,JavaScript 引擎会优先触发对应 trap,而不是直接执行原生行为。
- 例如,
gettrap 拦截属性读取:proxy.name会触发 handler.get(),你可以在其中返回任意值、抛出错误、或动态计算结果 -
settrap 拦截赋值:proxy.age = 30触发 handler.set(),可校验类型、拒绝非法值、触发更新通知 - 其他常用 trap 包括:
has(in 操作符)、deleteProperty(delete)、apply(函数调用)、construct(new 调用)等
为什么 Proxy 能做到原生级别的拦截?
Proxy 不是靠重写属性访问器(如 Object.defineProperty)模拟的,而是 V8 等引擎在语言层面提供的底层能力。每当 JS 引擎执行对象操作时,会先检查该对象是否为 Proxy 实例;如果是,就查找并执行对应的 trap 函数,跳过默认逻辑。这种机制保证了:
- 对新增属性自动生效(无需提前定义)
- 支持数组索引、Symbol 属性、原型链访问等完整语义
- 能拦截 for...in、Object.keys() 等枚举操作(通过 ownKeys / getOwnPropertyDescriptor 等 trap)
典型应用场景举例
Proxy 的灵活性让它成为现代框架的底层支柱:
立即学习“Java免费学习笔记(深入)”;
- 响应式系统:Vue 3 使用 Proxy 代理整个 data 对象,属性读写自动触发依赖收集与更新
-
数据验证:在 set trap 中检查值类型,
if (typeof value !== 'string') throw new Error('必须是字符串') - 负向代理/日志审计:所有 get/set 都打印日志,便于调试或监控字段访问模式
- 不可变封装:在 set、deleteProperty 等 trap 中一律抛错,对外提供只读视图
注意边界:Proxy 的局限性
Proxy 只代理直接作用于它的操作,不递归代理嵌套对象。若目标对象的某个属性本身是普通对象,对该属性内部的修改不会被拦截 —— 需手动递归 wrap 或结合 Reflect API 委托原生行为。
- 推荐在 trap 中使用
Reflect.get(target, key, receiver)替代target[key],保持 this 绑定和默认语义 - Proxy 实例与原对象分离,严格相等(===)返回 false;检测是否为 Proxy 需用
Object.isExtensible(proxy) === true等间接方式 - IE 完全不支持,需考虑兼容性降级方案(如 fallback 到 defineProperty)











