JavaScript代理对象Proxy使用详解

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《JavaScript代理对象Proxy怎么用》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

Proxy 是对目标对象的可编程拦截层，解决访问控制问题，如响应式、权限校验、日志等；必须传入对象 target 和 handler 对象，常用 get/set trap 需配合 Reflect 方法确保正确转发。

Proxy 是什么，它解决什么问题

Proxy 不是普通对象，而是对另一个对象的“拦截层”——你操作的是 Proxy 实例，但实际行为由你定义的 handler 控制。它不修改原对象，也不替代原对象，而是提供一层可编程的访问控制。常见用途包括：数据响应式（如 Vue 3）、权限校验、日志记录、不可变封装、属性访问兜底（类似 get 中返回默认值）。

必须传两个参数：target 和 handler

创建 Proxy 的语法固定为 new Proxy(target, handler)。漏掉任一参数都会报错：TypeError: Cannot create proxy with a non-object as target or handler。注意：target 必须是对象（含数组、函数、RegExp 等），null 或原始值（如 42、"str"）直接报错；handler 可以是空对象 {}，此时 Proxy 表现和原对象一致，但已具备扩展能力。

常见错误场景：

• 把 handler 写成 function 而非对象
• 误将字符串或数字直接传给 target，没包装成对象
• 在 handler 中忘记 return Reflect.get(...) 等默认转发，导致读取属性返回 undefined

get 和 set 是最常用且易出错的 trap

get(target, prop, receiver) 拦截属性读取；set(target, prop, value, receiver) 拦截赋值。关键点在于：它们不会自动执行原操作，必须显式调用 Reflect.get 或 Reflect.set（推荐）来触发默认行为，否则会静默失效。

const obj = { count: 0 };
const p = new Proxy(obj, {
  get(target, prop) {
    console.log(`读取 ${prop}`);
    return target[prop]; // ❌ 不推荐：绕过原型链、不支持 this 绑定
    // ✅ 推荐：return Reflect.get(target, prop, p);
  },
  set(target, prop, value) {
    if (prop === 'count' && typeof value !== 'number') {
      throw new Error('count 必须是数字');
    }
    target[prop] = value; // ❌ 风险：跳过 setter、忽略原型上同名 setter
    // ✅ 推荐：return Reflect.set(target, prop, value, p);
  }
});

遗漏 receiver 参数会导致 this 指向错误，尤其在访问 getter/setter 时；用 Reflect 方法能自动透传 receiver，避免这类 bug。

Proxy 无法代理非对象，也不能劫持已有属性的 descriptor

Proxy 只能代理对象本身，对它的属性是否可枚举、是否可配置等元信息（即 Object.getOwnPropertyDescriptor 返回的内容）无感知，也无法动态修改这些 descriptor。想监听属性定义（如 Object.defineProperty）需用 defineProperty trap；想拦截 in 操作符用 has；想让 for...in 只遍历特定属性，得配合 ownKeys + getOwnPropertyDescriptor trap。

真正容易被忽略的一点：Proxy 创建后，原对象仍可被直接访问。若业务逻辑同时混用 obj 和 p，响应式或校验就会失效——你得确保所有访问都走 Proxy 实例，且不要意外暴露 target。

好了，本文到此结束，带大家了解了《JavaScript代理对象Proxy使用详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！