如何将 ESM 测试与 jest 一起使用？

Question

我的设置

• 节点 v14.16.0
• 我有一个测试文件，其中包含一个使用 ESM 模块 (import) 编写的简单测试。
• 在package.json我有一个脚本（遵循Jest documentation适应Windows）："test": "set \"NODE_OPTIONS=--experimental-vm-modules\" && npx jest"
• 我的测试使用npm run test（上面的脚本）运行

我的目标：使用 jest 运行 ESM 测试。

我的尝试：

(1) 带有 .js 测试的 CommonJS 应用程序

• package.json 包含 "type": "commonjs"
• 测试文件名为test.js
• 错误：SyntaxError: Cannot use import statement outside a module（这是预期的，因为测试是作为 commonjs 文件运行的。）

(2) 带有 .mjs 测试的 CommonJS 应用程序

• package.json 包含 "type": "commonjs"
• 测试文件名为test.mjs
• 错误：No tests found（Jest 没有找到文件？）

(3) 带 .js 或 .mjs 的 ESM 应用程序

• package.json 现在有 "type": "module"
• 名为test.mjs 或test.js 的测试文件
• 错误：ReferenceError: module is not defined at ...jest.config.js:6:1

(4) CommonJS App和CommonJS测试

• package.json 包含 "type": "commonjs"
• 测试文件名为test.js，但使用commonjs require 语法（并且没有我想要包含的ESM 模块）；请注意，这不是我想要的，只是为了表明测试本身没有问题。
• 测试运行良好并通过

Answer 1

对我来说，只需将脚本“测试”设置如下：

"test": "cross-env NODE_OPTIONS=--experimental-vm-modules npx jest"

是的，别忘了 -> npm i cross-env jest

Answer 2

经过大量的摆弄，这是我成功的设置（重要的部分）：

• package.json有

  "type": "commonjs",
  "script": {
    "test": "NODE_OPTIONS=--experimental-vm-modules jest"
  }

• jest.config.mjs（是的，esModule）

export default {
  moduleFileExtensions: [
    "mjs",
    // must include "js" to pass validation https://github.com/facebook/jest/issues/12116
    "js",
  ],
  testRegex: `test\.mjs$`,
};

必须包含 "js" 是时代模块的历史遗物，其中显然是 .js 文件。关注https://github.com/facebook/jest/issues/12116 获取更新。

Answer 3

以下是我使用 ESM 通过测试运行 Jest 所采取的步骤。测试中的源文件也是使用 ESM 编写的。

1. 将我的节点版本设置为 14.16.0
2. npm i jest -D 将 Jest 安装为开发依赖项
3. 将"type": "module" 添加到package.json
4. 在package.json 中更新scripts 以包含"test": "node --experimental-vm-modules ./node_modules/.bin/jest"
5. 创建一个jest.config.js文件，内容如下：export default { transform: {} }
6. 至少有一个可以使用默认testMatch 找到的测试（我的在__tests__ 目录中）
7. npm test

在 GitHub 上的webpack-strip-debug-loader 存储库中有一个更完整的示例。