skillhub-009-tdd/mocking.md

When to Mock

仅在系统边界处进行 Mock：

• 外部 API（支付、邮件等）
• 数据库（偶尔使用——优先用测试数据库）
• 时间/随机性
• 文件系统（偶尔使用）

不要 Mock：

• 你自己的类/模块
• 内部协作组件
• 任何你能够控制的东西

为可 Mock 性而设计

在系统边界处，设计易于 Mock 的接口：

1. 使用依赖注入

将外部依赖传入，而非在内部创建：

// 易于 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

为每个外部操作创建特定函数，而非使用一个带条件逻辑的通用函数：

// 好：每个函数可独立 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 返回一种特定的数据结构
• 测试设置中无需条件逻辑
• 更容易看出某个测试覆盖了哪些端点
• 每个端点都有类型安全