# API Tester

> API测试技能 - IPC处理器发现、测试生成、健康检查、回归测试

- Skill: `chainlesschain/api-tester` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chainlesschain/api-tester`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chainlesschain/api-tester/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: chainlesschain (https://skillmd.com/u/chainlesschain)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chainlesschain/api-tester

---


# API 测试技能

## 描述

自动发现和测试 IPC 处理器及 REST API 端点。扫描源代码中的 `ipcMain.handle()` 注册，生成测试用例，执行健康检查和回归测试。

## 使用方法

```
/api-tester [操作] [目标路径] [选项]
```

## 操作

### 发现 IPC 处理器

```
/api-tester --discover src/main/
```

扫描所有源文件，提取:

- `ipcMain.handle('channel', handler)` 注册
- `ipcMain.on('channel', handler)` 监听器
- 处理器的参数签名和返回类型推断
- 模块归属和依赖关系

### 生成测试

```
/api-tester --generate src/main/audit/audit-ipc.js
```

为每个发现的处理器生成:

- 正常路径测试（有效输入 → 期望输出）
- 参数验证测试（缺失/无效参数 → 错误响应）
- Mock 注入（数据库、文件系统、外部服务）
- 边界条件测试
- 超时和并发测试

### 健康检查

```
/api-tester --health-check all
```

对所有已注册的 IPC 通道执行:

- 可达性检查（通道是否注册）
- 参数验证检查（空参数调用）
- 响应格式验证
- 响应时间测量

### 回归测试

```
/api-tester --regression src/main/marketplace/marketplace-ipc.js
```

基于已有测试用例:

- 运行所有相关测试
- 对比响应与基线快照
- 报告变化和异常

## 输出格式

### 发现报告

```
IPC Handler Discovery Report
=============================
Total handlers: 200+
By module:
  audit-ipc.js: 18 handlers
  marketplace-ipc.js: 22 handlers
  skills-ipc.js: 17 handlers
  ...
```

### 测试生成

生成可直接运行的 Vitest 测试文件:

```javascript
describe("audit-ipc handlers", () => {
  it("audit:get-logs should return paginated logs", async () => {
    // ...
  });
});
```

## 示例

发现所有 IPC 处理器:

```
/api-tester --discover src/main/
```

为特定模块生成测试:

```
/api-tester --generate src/main/hooks/hooks-ipc.js
```

运行全局健康检查:

```
/api-tester --health-check all
```