NestJS运行测试时Jest fake-timers报100_000语法错误如何解决

运行NestJS测试时始终收到测试套件运行失败提示，报错信息如下：

Test suite failed to run

.../node_modules/@jest/fake-timers/build/modernFakeTimers.js:181
      loopLimit: fakeTimersConfig.timerLimit || 100_000,
                                                ^^^

SyntaxError: Invalid or unexpected token

  at Object.<anonymous> (../node_modules/@jest/fake-timers/build/index.js:21:48)

当前运行环境为Node.js 12.0.0。

根因分析 #

该报错的核心原因是Node.js 12.0.0版本不支持数字字面量分隔符语法。
报错位置的100_000是ES2021标准新增的数字分隔符写法，作用是提升大数值的可读性，该特性在Node.js 12.22.0及以上版本才被正式支持。当前使用的12.0.0是Node 12分支的早期发布版本，无法识别该语法，在解析Jest依赖包代码时直接抛出语法解析异常，导致测试套件无法启动。

可行解决方案 #

• 升级Node.js版本（推荐方案）
  优先将Node.js升级到18.x、20.x这类官方长期维护的LTS版本，这类版本和新版NestJS、Jest生态的兼容性最好，不会出现新语法不识别的问题。升级完成后，删除项目下的node_modules目录和依赖锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml），重新执行依赖安装命令后再运行测试即可。如果必须保留Node 12大版本，最低需要升级到12.22.0以上的12.x终版，才能支持数字分隔符语法。
• 锁定Jest版本到兼容低版本Node的范围
  若受环境限制暂时无法升级Node.js版本，可以将项目内Jest相关依赖降级到兼容Node 12.0.0的旧版本：
  1. 卸载项目中当前已安装的所有Jest相关依赖
  2. 安装Jest 27.x及以下适配Node 12的版本，安装前务必删除原有node_modules目录和依赖锁文件，避免依赖树中残留高版本不兼容的子包。

注意：无论是升级Node版本还是降级Jest版本，完成操作后都要重新安装全量依赖，不要直接运行测试，避免旧依赖缓存导致报错复现。

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