Express 项目环境搭建 -- 17. 测试

接口写完不等于能用:参数边界、权限分支、错误返回都需要验证。这一篇用 supertest 对 Express 应用做 HTTP 级别的测试,并接入 node:test。

为什么用 supertest

supertest 可以把一个 Express 应用(或 http.Server)直接作为请求目标,自动绑定临时端口,不需要真的启动服务,也不需要管理端口号:

1
npm install --save-dev supertest

最小示例

1
2
3
4
5
6
7
8
const request = require("supertest");
const app = require("../src/app");

test("GET /api/v1/users 返回列表", async () => {
const res = await request(app).get("/api/v1/users");
expect(res.status).toBe(200);
expect(res.body).toEqual({ list: [] });
});

request(app) 返回一个链式对象,可以用 .send() 带请求体、.set() 带请求头、.expect() 做断言。

测试请求体校验

1
2
3
4
5
6
test("POST /api/v1/login 缺参数返回 400", async () => {
const res = await request(app)
.post("/api/v1/login")
.send({ email: "foo" });
expect(res.status).toBe(400);
});

测试鉴权

带 token 的请求用 .set() 注入请求头(鉴权中间件见第 8 篇):

1
2
3
4
test("无 token 访问受保护接口返回 401/403", async () => {
const res = await request(app).get("/api/v1/users");
expect(res.status).toBe(400);
});

用 node:test 组织

Node.js 内置测试运行器,不需要额外框架:

1
2
const test = require("node:test");
const assert = require("node:assert");
1
2
3
4
5
{
"scripts": {
"test": "node --test"
}
}

也可以换成 jest、mocha 等,supertest 与测试框架无关。

隔离测试环境

测试不应依赖开发数据库。常见做法是测试前把 NODE_ENV 设为 test,连接独立的测试库或内存数据库,并在每个用例前后清理数据:

1
process.env.NODE_ENV = "test";
1
2
3
test.beforeEach(async () => {
await clearTestData();
});

让测试可重复

  • 每个用例只验证一个行为。
  • 不依赖执行顺序。
  • 不依赖真实外部服务(用 mock 或内存实现替代)。
  • 测试通过与否应只由代码决定,而不是环境。

参考链接

系列导航


Express 项目环境搭建 -- 17. 测试
https://bubao.github.io/posts/5e6f7a8b.html
作者
一念
发布于
2026年11月21日
许可协议