globalOrWindow对象是什么？作用及相关报错触发场景咨询

这不是JavaScript标准内置API，也不是React Native官方暴露的全局变量，是第三方跨端类库内部自行封装的顶层对象引用变量，仅在对应类库的作用域内生效：

• 浏览器运行环境下，这个变量通常指向顶层对象window
• Node.js、React Native的JSC/Hermes引擎环境下，这个变量通常指向顶层对象global
• 适配了新标准的类库会直接将其指向统一顶层对象globalThis

核心作用是抹平不同JavaScript运行时的顶层对象差异，减少重复的环境判断代码：

• ES2020推出globalThis标准之前，不同JS环境的顶层对象不统一：浏览器用window、Node.js用global、Web Worker用self，跨端类库如果直接写死某一个顶层对象，在非目标环境就会直接报错
• 类库初始化时只需要做一次环境检测，给globalOrWindow赋上当前环境的正确顶层对象引用，后续所有读取全局属性、挂载全局方法的逻辑都可以直接基于这个变量开发，不用每次调用都写环境判断分支
• 除了globalOrWindow之外，这类兼容变量常见的命名还有root、globalRef、_global等，逻辑都是一致的。

这个报错的本质是globalOrWindow变量本身的值为undefined，后续链式读取.navigator.userAgent.toString()时触发了类型错误，常见触发场景如下：

• 第三方类库的环境兼容逻辑有缺陷：很多只做了Web端适配的类库，初始化时只判断了window是否存在，没有对React Native环境的global对象做判断，导致RN环境下globalOrWindow赋值失败，保留了初始的undefined值
• 依赖版本错配：项目里误装了Web端专属依赖（比如Web版埋点SDK、React DOM相关依赖），或者第三方依赖版本和当前使用的React Native版本不兼容，类库初始化逻辑执行异常
• 全局对象被异常篡改：项目里的前置执行脚本错误覆盖、删除了顶层global对象引用，或者在JS引擎初始化完成、全局对象挂载前就提前调用了依赖globalOrWindow的逻辑
• 打包配置错误：Metro打包时的依赖解析规则配置有误，错误将Web端的依赖入口打进了RN安装包，或者全局polyfill的加载顺序错误，导致类库初始化时拿不到正确的顶层对象引用

内容的提问来源于stack exchange，提问作者Malik Abdulaziz