原生JS子模块在Jest报Cannot use import statement outside a module错误如何修复
错误根因
该报错由Jest的ESM处理逻辑与你的项目配置不匹配导致,核心问题有三个:
- Jest 默认采用CommonJS运行环境,原生ESM支持需要手动开启,未转译的
import语句会直接抛出语法错误 - 你的
.helpers子模块目录没有被纳入转译/ESM识别范围,子模块内的ESM语法无法被Jest正常解析 - 你保留的
.babelrc存在test环境配置,Jest运行时会自动读取该配置尝试转译代码,但转译范围没有覆盖.helpers目录,反而导致转译不完整触发报错
修复方案
方案一:开启Jest原生ESM支持(推荐,适配纯原生ESM项目)
无需依赖Babel转译,直接开启Jest的原生ESM支持即可:
- 修改
Translator/package.json中的test脚本,添加Node ESM支持flag:
{ "scripts": { "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage --coverageDirectory=coverage", // 其余脚本保持不变 } }
- 在Jest配置块中新增ESM识别配置:
{ "jest": { "type": "module", "extensionsToTreatAsEsm": [".js"], "setupFiles": [ "<rootDir>/.jest/init.js", "<rootDir>/.jest/console.js" ], "collectCoverageFrom": [ "Translator/**/*test.js" ], "testPathIgnorePatterns": [ "<rootDir>/.helpers/" ], // 其余原有配置保持不变 } }
- 调整Babel配置避免干扰:将
.babelrc重命名为.babelrc.eslint,然后在ESlint配置文件中添加parserOptions: { babelOptions: { configFile: "./.babelrc.eslint" } },避免Jest运行时读取该Babel配置产生转译冲突。
方案二:调整Babel转译范围(兼容旧版Jest)
如果不想使用实验性的原生ESM特性,可调整Babel转译配置覆盖子模块目录:
- 修改Jest配置,添加转译规则覆盖
.helpers目录:
{ "jest": { "transformIgnorePatterns": [ "node_modules/(?!\\.helpers)" ], // 其余原有配置保持不变 } }
- 修改
.babelrc配置,添加include规则覆盖子模块:
{ "include": [ "./Translator/**/*", "./.helpers/**/*" ], "presets": [ ["@babel/preset-env", { "shippedProposals": true }] ], "env": { "test": { "plugins": ["@babel/plugin-transform-runtime"] } } }
修改完成后重新运行测试命令即可正常执行。
内容的提问来源于stack exchange,提问作者Eduardo Russo
相关产品推荐
相关产品推荐

