Jasmine 项目中 TypeScript 模块化测试的常见问题解析

在 JavaScript/TypeScript 测试领域，Jasmine 是一个广受欢迎的测试框架。然而，当开发者尝试将 Jasmine 与 TypeScript 的 ES 模块(ESM)结合使用时，经常会遇到一些棘手的配置问题。本文将深入分析这些问题的根源，并提供完整的解决方案。

问题现象

当开发者按照以下典型配置进行设置时：

1. 使用 TypeScript 编写测试代码
2. 在 package.json 中设置 "type": "module"
3. 通过 ts-node 运行 Jasmine 测试

通常会遇到 ERR_REQUIRE_ESM 错误，提示无法通过 require() 加载 ES 模块。这是因为 Node.js 的模块加载机制与 TypeScript 的模块系统之间存在不匹配。

核心问题分析

这个问题涉及多个层面的技术细节：

1. 模块系统冲突：Node.js 默认支持 CommonJS 和 ES 模块两种系统，但它们的加载机制不同
2. 文件扩展名处理：TypeScript 允许省略文件扩展名，但 Node.js 的 ES 模块加载器需要明确指定
3. 转译流程：ts-node 需要在模块加载前将 TypeScript 代码转译为 JavaScript

完整解决方案

1. 配置 ts-node 的 ESM 加载器

在运行测试命令时，需要明确告诉 ts-node 使用 ESM 加载器：

{
  "scripts": {
    "test": "ts-node --esm --project=tsconfig.json node_modules/jasmine/bin/jasmine --config=jasmine.json"
  }
}

2. 调整 TypeScript 配置

在 tsconfig.json 中需要添加以下关键配置：

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "NodeNext",
    "allowImportingTsExtensions": true,
    "outDir": "dist",
    "rootDir": "src"
  }
}

3. 规范导入语句

在 TypeScript 文件中，必须使用完整的导入路径，包括文件扩展名：

import { a } from "./main.ts";

4. 替代方案：使用 tsx

如果不想处理复杂的配置，可以考虑使用 tsx 替代 ts-node：

{
  "scripts": {
    "test": "tsx node_modules/jasmine/bin/jasmine --config=jasmine.json"
  }
}

tsx 能更好地处理 ES 模块和 TypeScript 的无扩展名导入。

最佳实践建议

1. 统一模块系统：在整个项目中保持一致，要么全部使用 ES 模块，要么全部使用 CommonJS
2. 明确文件扩展名：即使是 TypeScript 文件间的相互引用，也建议使用完整路径
3. 隔离测试环境：考虑将测试代码编译到 dist 目录后再运行，而不是直接运行 TypeScript 文件
4. 保持依赖更新：定期更新 Jasmine、TypeScript 和相关工具链，以获取最新的模块支持改进

总结

TypeScript 与 Jasmine 的结合使用确实需要一些额外的配置工作，特别是涉及到 ES 模块时。通过正确配置 ts-node 或使用替代工具如 tsx，开发者可以构建出稳定可靠的测试环境。理解这些配置背后的原理，有助于在遇到类似问题时快速定位和解决。