手动在Jenkins中运行TestCafe出现globalThis未定义报错的解决方法
报错根源
globalThis是ES2020规范定义的全局变量,Node.js 12.0.0及以上版本才内置支持。本次报错触发的原因是Jenkins执行TestCafe任务时,调用的Node版本低于12.0.0,无法识别globalThis,而依赖链上的queue-microtask、run-parallel这类新版包强制依赖该API,因此抛出未定义错误。
哪怕完成了官方文档的全部配置,只要执行环境的Node版本不满足最低要求,就会出现该问题。
第一步:定位版本问题
- 在Jenkins测试任务的执行脚本最顶部添加
node -v,运行任务查看输出的Node版本,确认是否低于v12.0.0 - 如果使用Jenkins NodeJS插件,检查全局工具配置中定义的Node版本是否为高版本,同时确认任务配置的“NodeJS版本”下拉项是否正确绑定了该高版本,避免 fallback 到系统PATH中的低版本Node
- 检查工作区的
node_modules是否是从其他高版本Node环境同步过来的,跨环境安装的依赖也可能和低版本运行环境不兼容
解决方案
永久修复(推荐)
升级Node.js版本到符合TestCafe要求的LTS版本(推荐16.x/18.x/20.x,最低不低于12.0.0):
- 若有节点权限,直接覆盖安装高版本Node到Jenkins节点环境
- 若无系统权限,通过Jenkins NodeJS插件配置独立的高版本Node工具链,在任务构建步骤中绑定该工具,执行时自动调用指定版本的Node,不修改系统原有环境
临时兼容方案(暂无法升级Node时使用)
通过前置注入polyfill补全globalThis定义:
- 在Jenkins工作区根目录新建
preload.js,写入以下内容:if (typeof globalThis === 'undefined') { var globalThis = Function('return this')(); } - 执行TestCafe命令时添加加载参数:
testcafe [原有测试参数] --require ./preload.js - 如果使用的是Node.js 10.12.0及以上的10.x版本,也可以在Node启动参数中添加
--experimental-global-this,开启实验性的globalThis支持
内容的提问来源于stack exchange,提问作者TS0306
相关产品推荐
相关产品推荐

