Proxy的核心用途是拦截对象的get、set、has、deleteProperty、ownKeys、defineProperty和getOwnPropertyDescriptor等内部操作。它不能代理原始值,仅适用于对象,且必须用Reflect转发原操作以避免死循环或行为丢失。

JavaScript 的 Proxy 不是网络代理,也不是“替你调用函数”的工具人;它是一套在运行时拦截并自定义对象基本操作的底层机制——本质是对象行为的“中间层”。用错地方容易引发无限递归、性能暴跌或意外的不可枚举性。
Proxy 的核心用途:拦截对象的哪些操作?
你不能靠它“自动重试请求”或“代理 API 调用”,它的作用域严格限定在 JS 对象的内部操作上。常见可拦截的目标包括:
-
get:读取属性(obj.x、obj['x']) -
set:设置属性(obj.x = 1) -
has:in操作符('x' in obj) -
deleteProperty:delete obj.x -
ownKeys:影响Object.keys()、for...in等枚举行为 -
defineProperty和getOwnPropertyDescriptor:控制属性描述符可见性
注意:Proxy 只能代理对象(包括数组、函数、Map 等),不能代理原始值(如 42、"str")。想代理基本类型,必须先包装成对象。
最简可用示例:实现响应式取值与赋值
这是新手最容易上手也最容易出错的场景。关键点在于:必须用 Reflect 转发原操作,否则会丢失默认行为或触发死循环。
立即学习“Java免费学习笔记(深入)”;
本文档主要讲述的是maven使用方法;Maven是基于项目对象模型的(pom),可以通过一小段描述信息来管理项目的构建,报告和文档的软件项目管理工具。Maven将你的注意力从昨夜基层转移到项目管理层。Maven项目已经能够知道 如何构建和捆绑代码,运行测试,生成文档并宿主项目网页。希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
const target = { count: 0 };
const proxy = new Proxy(target, {
get(obj, prop) {
console.log(`读取 ${prop}`);
return Reflect.get(obj, prop); // 必须用 Reflect.get,不能直接 obj[prop]
},
set(obj, prop, value) {
console.log(`设置 ${prop} = ${value}`);
return Reflect.set(obj, prop, value); // 必须用 Reflect.set
}
});
proxy.count++; // 输出:读取 count → 设置 count = 1
错误写法示例(会导致无限递归):
get(obj, prop) {
return obj[prop]; // ❌ 直接访问 proxy 包裹的对象,又触发 get → 死循环
}
为什么不能直接修改 handler 中的 this 或 target?
Proxy 的 handler 是纯逻辑层,不持有状态。所有副作用(如缓存、日志、通知)必须显式维护变量或闭包。另外,target 一旦传入 new Proxy() 就不可更换;想“切换目标”,只能新建一个 Proxy 实例。
- 不要在
get里改target的属性,除非你明确知道这会再次触发拦截 -
proxy和target是两个独立对象:对proxy的操作走拦截逻辑,对target的操作完全绕过Proxy - 如果
target是冻结对象(Object.freeze()),set拦截中Reflect.set()会返回false,需手动处理失败
实际项目中容易被忽略的坑
多数人只想到“拦截读写”,但真实环境里这些细节更致命:
-
Array.prototype.push内部会触发多次set+get('length'),若没正确处理length更新,数组行为会异常 -
for...in遍历依赖ownKeys和has,缺一不可;否则代理对象看起来“空空如也” - V8 引擎对
Proxy有优化限制:高频调用的简单对象(如配置项)用Proxy可能比普通对象慢 2–5 倍 - 使用
JSON.stringify(proxy)会静默失败(返回空对象),因为JSON不走get,而是直接查ownKeys+getOwnPropertyDescriptor
真正难的不是写一个 Proxy,而是判断某个需求是否真的需要它——很多时候,用 class + getter/setter 更轻量、更可控、更容易调试。










