Mocha + TypeScript：无法在模块外部使用 import 语句

typescript

使用Mocha和typescript进行测试时，有时会遇到无法在模块外部使用import语句的问题。这可能会导致一些困扰，特别是当我们想在测试代码中引入外部模块时。本文将介绍这个问题的原因，并提供一些解决方案。

问题描述

当我们在Mocha测试中使用typescript时，我们经常会遇到这样的情况：在测试文件中，我们想要引入外部的模块，比如一个工具函数或者一个类。通常情况下，我们会使用import语句来引入这些模块。然而，当我们尝试在模块外部使用import语句时，typescript会报错，提示我们import语句只能在模块内部使用。

问题原因

这个问题的原因是因为Mocha默认情况下将测试文件视为脚本文件而不是模块文件。在脚本文件中，我们无法使用import语句来引入外部模块。这是因为脚本文件在没有特殊处理的情况下默认是全局作用域，无法识别模块的导入语法。

解决方案

要解决这个问题，我们可以采用以下几种方法。

1. 将测试文件转换为模块文件

将测试文件转换为模块文件是最简单的解决方案之一。我们可以通过在测试文件的开头添加一行类似于export {}的语句来将其转换为模块文件。这样一来，我们就可以在测试文件中使用import语句了。

下面是一个示例代码：

typescript
// test.ts
export {};
import { expect } from 'chAI';
import { sum } from './utils';
describe('sum', () => {
  it('should return the sum of two numbers', () => {
    expect(sum(1, 2)).to.equal(3);
  });
});

在上面的代码中，我们在测试文件的开头添加了export {}语句，将其转换为模块文件。然后我们就可以在测试代码中使用import语句了。

2. 使用require语句

另一种解决方案是使用require语句来引入外部模块。在Node.JS环境下，我们可以使用require语句来引入模块。这种方式不需要将测试文件转换为模块文件，但是需要注意的是，使用require语句来引入模块与使用import语句有一些细微的差别。

下面是一个示例代码：

typescript
// test.ts
const { expect } = require('chAI');
const { sum } = require('./utils');
describe('sum', () => {
  it('should return the sum of two numbers', () => {
    expect(sum(1, 2)).to.equal(3);
  });
});

在上面的代码中，我们使用require语句来引入chAI和utils模块。这样一来，我们就可以在测试代码中使用这些模块了。

3. 使用ts-node运行测试

如果我们希望在测试代码中继续使用import语句，并且不想将测试文件转换为模块文件或者使用require语句，我们可以使用ts-node来运行测试。ts-node是一个typescript解释器，它可以直接运行typescript代码而不需要进行编译。

首先，我们需要全局安装ts-node：

npm install -g ts-node

然后，我们可以使用以下命令来运行测试：

ts-node ./test.ts

这样一来，我们就可以在测试代码中继续使用import语句了。

在使用Mocha和typescript进行测试时，无法在模块外部使用import语句是一个常见的问题。我们可以通过将测试文件转换为模块文件、使用require语句或者使用ts-node来解决这个问题。选择哪种解决方案取决于具体的需求和场景。希望本文对你解决这个问题有所帮助！