如何用 Proxy 代理一个对象并在访问不存在的属性时抛出友好提示

云芳小哥_5954

云芳小哥_5954

2026-04-15

988人浏览

原创

get拦截器是proxy访问不存在属性的关键入口,需先用reflect.ownkeys判断自身属性是否存在,再结合getownpropertydescriptor排除getter/setter,最后对真非法访问抛错。

如何用 proxy 代理一个对象并在访问不存在的属性时抛出友好提示

Proxy 代理对象时,get 拦截器是关键入口

访问不存在的属性触发的是 get 拦截器,不是 has 或 ownKeys。只要目标对象上没有该属性(包括原型链上也查不到),且你没在 get 里显式返回值,就会走默认行为(返回 undefined)。想抛错,就得在 get 里主动判断。

注意:不能只检查 target.hasOwnProperty(key),因为这会漏掉原型上的自有属性;更稳妥的是用 Object.prototype.hasOwnProperty.call(target, key) 配合 key in target 判断是否“真正不可访问”——但实际中,多数场景只需拦截“目标对象自身无、且非 Symbol/内部方法”的访问。

  • 推荐先用 Reflect.get(target, key, receiver) 获取原始值,再判断是否为 undefined 且该 key 不是函数名(避免误伤 toString 等)
  • 排除常见内置属性:key === 'toString' || key === 'valueOf' || typeof key === 'symbol'
  • 如果目标对象是类实例,还要小心 constructor、__proto__ 等,建议白名单放行或跳过

抛错前要区分“真不存在”和“值就是 undefined”

直接对所有 undefined 返回值抛错会破坏正常逻辑——比如一个合法字段本就初始化为 undefined,或者被显式设为 undefined。必须结合属性是否存在做双重判断。

最简可靠方式是:先用 Object.keys(target).includes(key) 或 Reflect.ownKeys(target).includes(key) 查自身属性;若不包含,再确认它不是访问器属性(Object.getOwnPropertyDescriptor(target, key) 返回 undefined),才认定为“非法访问”。

aperture: the L402 aware reverse proxy
aperture: the L402 aware reverse proxy

安装并运行 Aperture(Lightning Labs 的 L402 闪电反向代理),用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载
  • Reflect.ownKeys(target) 比 Object.keys() 更全,能捕获不可枚举属性和 Symbol
  • 如果目标对象有 getter/setter,getOwnPropertyDescriptor 会返回描述符,此时不应报错
  • 别忘了检查 key 类型:字符串或 Symbol,避免对 0、null 等意外输入抛错

完整可复用的友好提示 Proxy 封装

下面是一个轻量封装,支持传入自定义提示模板,且避开常见陷阱:

function createStrictProxy(target, options = {}) {
  const { message = 'Property "%s" does not exist on %s', className = target.constructor?.name || 'object' } = options;
  
  return new Proxy(target, {
    get(obj, key, receiver) {
      // 放行原型方法、Symbol、私有字段(_ 开头可选)、内部属性
      if (typeof key === 'symbol' || key in Object.prototype || key === 'constructor') return Reflect.get(obj, key, receiver);
      
      const desc = Object.getOwnPropertyDescriptor(obj, key);
      if (desc !== undefined) return Reflect.get(obj, key, receiver); // 有描述符,说明是合法定义(含 getter)

      // 真正不存在:自身无 + 非原型继承来的方法
      const ownKeys = Reflect.ownKeys(obj);
      if (!ownKeys.includes(key)) {
        throw new ReferenceError(
          message.replace('%s', `"${String(key)}"`).replace('%s', className)
        );
      }

      return Reflect.get(obj, key, receiver);
    }
  });
}

使用示例:

const user = createStrictProxy({ name: 'Alice' }, { message: '⚠️ No such field: %s on %s' });
user.name; // 'Alice'
user.age;  // 抛出 ReferenceError: ⚠️ No such field: "age" on object

容易被忽略的边界情况

Proxy 的 get 拦截器不会捕获数组索引访问的“越界”,比如 arr[100] 即使 length === 0 也只返回 undefined,不会进 get——因为数组的索引访问走的是 [[Get]] 内部方法,而 Proxy 对稀疏数组索引的拦截依赖于 target 是否为 Array 且是否设置了 length 等元信息。简单起见,如需拦截数组越界,应单独处理或改用类包装。

  • Proxy 无法拦截 for...in 中的原型属性遍历,get 不触发;要用 ownKeys + getOwnPropertyDescriptor 组合控制
  • 严格模式下,对 non-configurable 属性赋 undefined 会静默失败,但 Proxy 的 get 仍会被调用——这点常被误认为“没生效”
  • 如果目标对象被冻结(Object.freeze()),Proxy 依然有效,但要注意 set 拦截器可能因目标不可写而失效

真正麻烦的是嵌套对象:Proxy 只代理一层,深层属性访问不会自动递归代理。需要手动 wrap 子对象,或在 get 里判断返回值是否为对象并返回新 Proxy ——但这会带来性能开销和循环引用风险。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

proxy

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5006

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1229

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4944

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

960

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1896

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3525

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

4593

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3020

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

968

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.8万人学习