Proxy是JavaScript用于拦截并自定义对象基本操作的代理构造函数，通过handler提供get、set、has、deleteProperty等trap拦截读写、枚举、构造等行为，支持校验、日志、响应式等场景。
JavaScript 的 Proxy 对象是一个用于创建代理（proxy）以拦截并自定义对目标对象基本操作的内置构造函数。 它不是用来替代对象的，而是“包一层”，让开发者能在读取、赋值、删除、遍历等关键行为发生时插入自己的逻辑——比如校验、日志、响应式更新、权限控制等。
Proxy 能拦截哪些操作？
Proxy 通过 handler（处理器）对象 提供一系列可选的捕获器（traps），每个 trap 对应一种底层操作。常用且高频的包括：
-
get(target, prop, receiver)：拦截读取属性（
obj.x、obj['x']）、访问原型链上的属性，也用于in操作符和for...in遍历的属性存在性检查。 -
set(target, prop, value, receiver)：拦截设置属性（
obj.x = 1、obj['x'] = 1），可阻止赋值、转换类型、触发通知等。 -
has(target, prop)：拦截
prop in obj操作，控制属性“是否存在”的语义。 -
deleteProperty(target, prop)：拦截
delete obj.x，可禁止删除或做清理工作。 -
ownKeys(target)：拦截
Object.getOwnPropertyNames()、Object.keys()、for...in等枚举操作，能隐藏或动态添加键名。 -
defineProperty(target, prop, descriptor)：拦截
Object.defineProperty()调用，控制属性描述符是否生效。 -
getOwnPropertyDescriptor(target, prop)：拦截
Object.getOwnPropertyDescriptor()，可伪造或过滤属性描述信息。 -
construct(target, args, newTarget)：仅对函数/类代理有效，拦截
new ProxyFn(...)调用，可返回自定义实例。 -
apply(target, thisArg, args)：仅对函数代理有效，拦截函数调用（
proxyFn(...)），可用于装饰、节流、参数预处理等。
一个简单但典型的例子
比如用 Proxy 实现一个带数据校验的“安全对象”：
const validator = {
set(obj, prop, value) {
if (prop === 'age' && typeof value !== 'number') {
throw new Error('age 必须是数字');
}
obj[prop] = value;
return true; // 必须返回 true 表示设置成功
}
};
const person = new Proxy({}, validator);
person.name = '张三'; // ✅ 正常
person.age = 25; // ✅ 正常
person.age = '25'; // ❌ 抛出错误
注意几个关键细节
- Proxy 只代理**直接操作**，不递归代理嵌套对象；若需深度代理，得在
get中对返回的 object 再套一层 Proxy。 - 某些操作（如
Object.isExtensible()）有对应的 trap（isExtensible），但默认行为由目标对象决定；若 handler 没定义该 trap，就透传给目标对象。 - Proxy 无法拦截所有操作：例如
obj.toString()不走get（除非显式重写toString属性），而obj + ''会触发toPrimitive（需配合Symbol.toPrimitive）。 - 被代理的对象（target）与 Proxy 实例是分离的；修改 target 本身不会触发 handler，只有通过 Proxy 实例的操作才会被拦截。
它不是语法糖，而是 JavaScript 提供的一套底层元编程能力，Vue 3 的响应式系统、各类 mock 工具、API 封装层都重度依赖 Proxy。
立即学习“Java免费学习笔记（深入）”；
