モッキングとスタビング

目次

• 概要
• 使用時機
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

モッキングとスタビングは、依存関係を制御されたテストダブルで置き換えることにより、テスト中のコード単位を分離するための必須テクニックです。これにより、データベース、API、ファイルシステムなどの外部システムに依存しない、高速で信頼性の高い、焦点を絞ったユニットテストが可能になります。

使用時機

• ユニットテストを外部依存から分離する
• 遅い操作（DB、ネットワーク）に依存するコードをテストする
• エラー条件とエッジケースをシミュレートする
• オブジェクト間のインタラクションを検証する
• 非決定論的な動作（時間、ランダム性）を持つコードをテストする
• テスト内の高コストな操作を避ける
• 実際の障害をトリガーすることなくエラーハンドリングをテストする

クイックスタート

最小限の実装例：

// services/UserService.ts
import { UserRepository } from "./UserRepository";
import { EmailService } from "./EmailService";

export class UserService {
  constructor(
    private userRepository: UserRepository,
    private emailService: EmailService,
  ) {}

  async createUser(userData: CreateUserDto) {
    const user = await this.userRepository.create(userData);
    await this.emailService.sendWelcomeEmail(user.email, user.name);
    return user;
  }

  async getUserStats(userId: string) {
    const user = await this.userRepository.findById(userId);
    if (!user) throw new Error("User not found");

    const orderCount = await this.userRepository.getOrderCount(userId);
    return { ...user, orderCount };
  }
}

// ... (see reference guides for full implementation)

リファレンスガイド

references/ ディレクトリの詳細実装：

ガイド	内容
Jest モッキング（JavaScript/TypeScript）	Jest モッキング（JavaScript/TypeScript）
Python モッキング（unittest.mock）	Python モッキング（unittest.mock）
Java 用 Mockito	Java 用 Mockito
高度なモッキングパターン	高度なモッキングパターン

ベストプラクティス

✅ すべき事

• 外部依存（DB、API、ファイルシステム）をモックする
• より簡単にモッキングするために依存性注入を使う
• モックを使った重要なインタラクションを検証する
• テスト間でモックをリセットする
• 境界でモックする（リポジトリ、サービス）
• 必要に応じて部分的なモッキングにスパイを使う
• 再利用可能なモックファクトリを作成する
• 成功シナリオと失敗シナリオの両方をテストする

❌ すべきでない事

• すべてをモックする（自分が所有していないものはモックしない）
• モックインタラクションを過度に指定する
• 統合テストでモックを使う
• 単純なユーティリティ関数をモックする
• 複雑なモック階層を作成する
• モック呼び出しの検証を忘れる
• テスト間でモックを共有する
• テストを通すだけのためにモックする