wehub-skill-sync
60 lines
1.4 KiB
Markdown
60 lines
1.4 KiB
Markdown
# When to Mock
|
||
|
||
仅在**系统边界**处进行 Mock：
|
||
|
||
- 外部 API（支付、邮件等）
|
||
- 数据库（偶尔使用——优先用测试数据库）
|
||
- 时间/随机性
|
||
- 文件系统（偶尔使用）
|
||
|
||
不要 Mock：
|
||
|
||
- 你自己的类/模块
|
||
- 内部协作组件
|
||
- 任何你能够控制的东西
|
||
|
||
## 为可 Mock 性而设计
|
||
|
||
在系统边界处，设计易于 Mock 的接口：
|
||
|
||
**1. 使用依赖注入**
|
||
|
||
将外部依赖传入，而非在内部创建：
|
||
|
||
```typescript
|
||
// 易于 Mock
|
||
function processPayment(order, paymentClient) {
|
||
return paymentClient.charge(order.total);
|
||
}
|
||
|
||
// 难以 Mock
|
||
function processPayment(order) {
|
||
const client = new StripeClient(process.env.STRIPE_KEY);
|
||
return client.charge(order.total);
|
||
}
|
||
```
|
||
|
||
**2. 优先采用 SDK 风格的接口，而非通用 fetcher**
|
||
|
||
为每个外部操作创建特定函数，而非使用一个带条件逻辑的通用函数：
|
||
|
||
```typescript
|
||
// 好：每个函数可独立 Mock
|
||
const api = {
|
||
getUser: (id) => fetch(`/users/${id}`),
|
||
getOrders: (userId) => fetch(`/users/${userId}/orders`),
|
||
createOrder: (data) => fetch('/orders', { method: 'POST', body: data }),
|
||
};
|
||
|
||
// 差：Mock 需要在内部实现条件逻辑
|
||
const api = {
|
||
fetch: (endpoint, options) => fetch(endpoint, options),
|
||
};
|
||
```
|
||
|
||
SDK 方式意味着：
|
||
- 每个 Mock 返回一种特定的数据结构
|
||
- 测试设置中无需条件逻辑
|
||
- 更容易看出某个测试覆盖了哪些端点
|
||
- 每个端点都有类型安全
|