17370845950

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。