Node环境无法导入Emscripten生成的ES6格式JS文件问题

你的核心问题是Jest对原生ESM中import.meta的支持不完善，具体细节：

1. 虽然项目已标记"type": "module"，但Jest的jsdom测试环境默认无法处理import.meta.url这类ESM特有语法——Emscripten生成的ES6胶水代码直接使用了该语法，导致测试报错。
2. 你尝试去掉EXPORT_ES6生成CommonJS版本，虽然解决了测试问题，但Web环境（Vite）中ESM导入CJS模块时，默认导出的处理逻辑与Node不一致，导致Web端无法获取正确的模块实例。

方案一：用Babel转译处理import.meta #

通过Babel将胶水代码中的import.meta.url转译为Jest可识别的语法，同时保留ESM格式：

1. 安装依赖：

   yarn add -D @babel/core babel-jest @babel/preset-env babel-plugin-transform-import-meta
   

2. 修改package.json中的Jest配置：

   "jest": {
     "preset": "ts-jest",
     "testEnvironment": "jsdom",
     "roots": ["<rootDir>/src"],
     "transform": {
       "^.+\\.tsx?$": "ts-jest",
       "^.+\\.js$": "babel-jest" // 让Babel处理Emscripten生成的JS文件
     },
     "testRegex": "(/__tests__/.*|(\\.|/)(test|spec))\\.tsx?$",
     "setupFilesAfterEnv": ["./src/jest.setup.ts"],
     "extensionsToTreatAsEsm": [".ts", ".tsx", ".js"], // 将JS文件当作ESM处理
     "globals": {
       "ts-jest": {
         "useESM": true // 让ts-jest以ESM模式处理TS文件
       }
     }
   }
   

3. 项目根目录创建babel.config.json：

   {
     "presets": [["@babel/preset-env", { "targets": { "node": "current" } }]],
     "plugins": [["babel-plugin-transform-import-meta", { "module": "esm" }]]
   }
   

4. 修改测试脚本：

   "scripts": {
     "test": "NODE_OPTIONS=--experimental-vm-modules jest"
   }
   

   该命令开启Node的ESM实验支持，确保Jest能正确加载转译后的模块。

方案二：分环境生成不同版本的Wasm模块 #

为Web和测试/Node环境分别编译ESM和CJS版本的模块，通过条件导出自动适配：

1. 执行两次Emscripten编译命令：
   • Web用ESM版本：

     emcc your_code.cpp --bind -s ALLOW_MEMORY_GROWTH=1 -s MODULARIZE=1 -s EXPORT_ES6 --emit-tsd EmscriptenGeneratedModule.d.ts -o EmscriptenGeneratedModule.esm.js
     

   • 测试/Node用CJS版本：

     emcc your_code.cpp --bind -s ALLOW_MEMORY_GROWTH=1 -s MODULARIZE=1 --emit-tsd EmscriptenGeneratedModule.d.ts -o EmscriptenGeneratedModule.cjs.js
     

2. 在package.json中配置条件导出：

   "exports": {
     ".": {
       "browser": "./EmscriptenGeneratedModule.esm.js",
       "node": "./EmscriptenGeneratedModule.cjs.js",
       "default": "./EmscriptenGeneratedModule.esm.js"
     }
   }
   

3. 代码中正常导入即可：

   import MainModuleFactory from './EmscriptenGeneratedModule';
   

   不同环境会自动加载对应的模块版本，既保证Web端正常运行，也解决测试中的语法问题。

方案三：Mock Wasm模块（无需真实执行计算） #

如果你的测试仅需验证调用逻辑，不需要实际运行Wasm的高消耗计算，可以直接Mock模块：
在测试文件顶部添加：

jest.mock('./EmscriptenGeneratedModule', () => {
  // 模拟模块工厂函数，返回所需的Mock实例
  return jest.fn().mockResolvedValue({
    // 替换为你的Wasm模块实际导出的方法/属性
    heavyCalculation: jest.fn().mockReturnValue(123)
  });
});

这种方式完全避开加载真实胶水代码的问题，适合单元测试场景。

内容的提问来源于stack exchange，提问作者Filip Wiśniewski