globalThis是ES2020引入的统一全局对象访问标准,兼容所有JavaScript环境;它在浏览器中等价于window,在Node.js中等价于global,在Web Worker中等价于self,解决了跨环境全局对象不一致问题。

在浏览器环境中,window 是默认的全局对象;但在 Node.js、Web Workers、Service Workers 或某些打包工具(如 Webpack)生成的沙箱环境里,window 可能不存在或不指向真正的全局作用域。为统一访问全局对象,ES2020 引入了 globalThis —— 它在所有 JavaScript 环境中都可用,且始终指向当前执行上下文的全局对象。
为什么不能只用 window
window 仅在浏览器主窗口(包括 iframe)中存在,其他环境会报错:
- Node.js 中访问
window抛出ReferenceError: window is not defined - Web Worker 中
window不可用,应使用self - 某些模块打包后运行在非浏览器沙箱中,
window被重定义或屏蔽
globalThis 的兼容性现状
globalThis 已被主流环境广泛支持:
- Chrome 71+、Firefox 65+、Safari 12.1+、Edge 79+
- Node.js 12.0+(v12.0.0 起默认启用)
- 所有现代 Web Worker 和 Service Worker 环境
但 IE 和旧版 Node.js(
立即学习“Java免费学习笔记(深入)”;
安全可靠的兼容写法
推荐使用以下模式,兼顾可读性与兼容性:
const getGlobal = () => {
if (typeof globalThis !== 'undefined') return globalThis;
if (typeof self !== 'undefined') return self;
if (typeof window !== 'undefined') return window;
if (typeof global !== 'undefined') return global;
throw new Error('Unable to locate global object');
};
const globalObj = getGlobal();
也可简写为一行(适合工具函数或 polyfill 场景):
const globalObj = typeof globalThis !== 'undefined' ? globalThis :
typeof self !== 'undefined' ? self :
typeof window !== 'undefined' ? window :
typeof global !== 'undefined' ? global :
undefined;
实际使用建议
避免直接依赖 window 或 global 做功能判断,例如:
- 检测是否在浏览器中:用
typeof window !== 'undefined' && window.document,而不是仅看window - 挂载全局变量:优先写
globalThis.MyLib = {...},而非window.MyLib = {...} - 写通用 polyfill 时,一律通过
globalThis访问/扩展内置对象(如globalThis.Promise)
构建项目时,若需支持老旧环境(如 IE),可通过 Babel 插件 @babel/plugin-transform-runtime 自动注入 globalThis polyfill,或使用轻量 polyfill 库(如 globalthis)。











