egg-unittest

name	egg-unittest
description	本技能用于编写 EGG 应用的单元测试。覆盖 HTTP 接口测试、Service/DI 对象测试、Mock 数据模拟、BackgroundTask 和 EventBus 测试。使用 @eggjs/mock、app.httpRequest()、app.getEggObject()、mm() 等 API。
allowed-tools	Read

EGG 单元测试

---

原理

egg-bin test 使用 Vitest 运行测试，自动完成以下工作：

• 以当前项目目录为 baseDir，创建并启动一个 MockApplication 实例（即 app）
• 注入 @eggjs/mock/setup_vitest 管理 app 生命周期（beforeAll 启动 app、afterEach 恢复 mock、afterAll 关闭 app）
• 注入 Vitest 全局变量（describe、it、beforeAll 等），无需手动 import 测试代码中通过 import { app, mm } from '@eggjs/mock/bootstrap' 获取已启动的 app 实例和 mock 工具，直接使用即可。

---

配置检查

确保项目中有以下配置：

package.json：

{
  "scripts": {
    "test": "egg-bin test"
  },
  "devDependencies": {
    "@eggjs/bin": "^8"