Node.js 20.18中Reflect.get传入receiver参数返回undefined的问题排查与原因分析

我完全能理解你碰到这个问题的困惑——明明对Reflect.get的认知是它只影响getter的this指向，结果在Node.js 20.18里带receiver就返回undefined，不带反而正常，Node.js 16又没这问题，换谁都会怀疑是不是V8出bug了。结合你提供的调试细节、复现代码和Vitest相关场景，咱们来拆解一下这个问题：

一、问题现象复盘 #

先把核心情况理清楚：

• 在Node.js 20.18环境下，对Vitest模拟的window对象创建Proxy，当get陷阱里调用Reflect.get(target, p, receiver)时，addEventListener这类属性会返回undefined；但去掉receiver参数用Reflect.get(target, p)就能拿到正常值。
• 调试时发现：展开target的成员变量找不到p对应的属性（包括遍历原型链），但hasOwnProperty返回true，而且Object.entries(target)也列不出这些属性（比如addEventListener、removeEventListener）。
• 相同逻辑在Node.js 16.20里完全正常，因此你怀疑是V8版本差异导致的问题。

二、核心原因分析 #

1. Reflect.get的receiver参数作用 #

你对Reflect.get的理解是对的——它的第三个参数receiver确实主要用来改变getter函数中的this指向。但这里的特殊点在于：我们操作的不是普通自定义对象，而是Vitest模拟的浏览器window对象，这类内置对象的属性通常有特殊的属性描述符（比如不可枚举、或者通过getter/setter实现）。

当你传递receiver（也就是当前的Proxy实例）给Reflect.get时，Node.js 20.18使用的V8 11.3版本中，对内置对象属性的访问逻辑可能发生了变化：

• 对于window上的方法（比如addEventListener），它们的getter可能会校验this的指向是否符合浏览器环境的预期；当this变成Proxy实例时，getter可能直接返回undefined或者触发隐藏的校验逻辑。
• 而如果不传递receiver，Reflect.get会用target作为this调用getter，这时候符合内置方法的预期，就能正常返回值。

2. V8版本差异的影响 #

Node.js 16.20使用的是V8 9.4，Node.js 20.18升级到了V8 11.3，这两个版本之间V8对内置对象的代理处理、getter的this校验逻辑可能有了更新。不排除是V8在实现某些规范更新时引入了bug，或者是对内置对象的安全校验变得更严格，导致Proxy作为receiver时无法正常获取属性值。

3. 复现代码的佐证 #

你写的简化复现代码也能侧面反映这个逻辑：

const myObj = {
    aa: 'aa'
}

Object.defineProperty(myObj, 'a', {
    get () {
        return this.aa
    }
})

const myProxyObj = new Proxy({
    a: 'a'
}, {
    get(target, prop, receiver) {
        return Reflect.get(target, prop, receiver)
    }
})

console.log(Reflect.get(myObj, 'a', myProxyObj)) // 这里会返回undefined，因为myProxyObj没有aa属性
console.log('a' in myObj)
console.log('a' in myProxyObj)
console.log(Object.hasOwn(myObj, 'a'))
console.log(Object.hasOwn(myProxyObj, 'a'))

当用myProxyObj作为receiver去取myObj.a时，getter里的this是myProxyObj，而myProxyObj没有aa属性，所以返回undefined——这和你在Vitest里遇到的情况本质类似：window方法的getter依赖this是真实的window对象，当this变成Proxy时，就无法正常返回值。

三、临时解决方案 #

如果你需要暂时解决这个问题，可以尝试在Proxy的get陷阱里做特殊处理：

• 对于window上的内置方法（比如addEventListener、removeEventListener），直接返回target[p]，不使用带receiver的Reflect.get；
• 或者判断属性是否为内置方法，调用Reflect.get(target, p)而不是传递receiver参数。

示例代码：

const globalProxy = new Proxy(win.window, {
  get(target, p, receiver){
    // 针对特定内置方法，不传递receiver
    const builtInMethods = ['addEventListener', 'removeEventListener', 'dispatchEvent'];
    if (builtInMethods.includes(p)) {
      return Reflect.get(target, p);
    }
    // 其他属性正常处理
    return Reflect.get(target, p, receiver);
  }
})

四、后续验证建议 #

你可以尝试在纯Node.js环境（不用Vitest模拟window）下，用原生的globalThis做类似的Proxy测试：

• 如果纯Node环境没问题，那大概率是Vitest模拟的window对象和Node.js 20的V8版本不兼容导致的；
• 如果纯Node环境也能复现，那基本可以确定是V8的bug，可以去V8的官方issue仓库提交反馈。

备注：内容来源于stack exchange，提问作者snick8090