使用Mocha、Chai、Supertest和Sinon搭建Node.js单元测试框架,1. 选择Mocha为测试运行器,Chai作断言库,Supertest发HTTP请求;2. 安装依赖并组织test/目录结构;3. 编写测试用例验证API行为;4. 用Sinon模拟数据库避免外部依赖;5. 配置npm脚本运行测试并用nyc生成覆盖率报告。

选择测试工具和断言库
推荐使用 Mocha 作为测试运行器,它支持异步测试并提供清晰的测试结构。Chai 是一个灵活的断言库,配合 Supertest 可以轻松发起HTTP请求并验证响应。
安装依赖:
- npm install --save-dev mocha chai supertest
- 确保你的项目中已安装 express(或其他Web框架)
组织测试文件结构
将测试文件放在 test/ 目录下,每个API路由对应一个测试文件,例如 test/user.test.js。测试前启动服务器或直接引用应用实例。
示例代码(假设使用Express):
const request = require('supertest');
const app = require('../app'); // 引入Express应用
const expect = require('chai').expect;
describe('GET /api/users', () => {
it('应返回用户列表,状态码200', (done) => {
request(app)
.get('/api/users')
.expect(200)
.end((err, res) => {
if (err) return done(err);
expect(res.body).to.be.an('array');
done();
});
});
});
模拟数据库和外部依赖
避免在单元测试中连接真实数据库。可以使用 sinon.js 模拟服务层方法,或用内存数据替代模型操作。
例如,使用Sinon替换User.find:
- npm install --save-dev sinon
- 在测试中用 sinon.stub(User, 'find').resolves([]) 模拟返回空数组
这样能隔离业务逻辑,专注接口行为验证。
运行测试并生成报告
在 package.json 中添加脚本:
"scripts": {
"test": "mocha test/**/*.test.js --timeout 5000"
}
执行 npm test 即可运行所有测试。可选添加 nyc 生成代码覆盖率报告:
- npm install --save-dev nyc
- 修改脚本:"test:coverage": "nyc npm test"










