統合テスト

目次

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

概要

統合テストは、異なるコンポーネント、モジュール、またはサービスが正しく連携して動作することを検証します。単一の関数を分離するユニットテストとは異なり、統合テストは、データベース、API、外部サービス、インフラストラクチャを含むシステムの複数の部分間の相互作用を検証します。

使用する場合

• 実際のデータベース接続を使用した API エンドポイントのテスト
• サービス間通信の検証
• 複数のレイヤー間のデータフローの検証
• 実際のデータベースを使用したリポジトリ/DAO レイヤーのテスト
• 認証・認可フローの確認
• メッセージキューコンシューマー・プロデューサーのテスト
• サードパーティサービス統合のテスト

クイックスタート

最小限の動作例:

// test/api/users.integration.test.js
const request = require("supertest");
const app = require("../../src/app");
const { setupTestDB, teardownTestDB } = require("../helpers/db");

describe("User API Integration Tests", () => {
  beforeAll(async () => {
    await setupTestDB();
  });

  afterAll(async () => {
    await teardownTestDB();
  });

  beforeEach(async () => {
    await clearUsers();
  });

  describe("POST /api/users", () => {
    it("should create a new user with valid data", async () => {
      const userData = {
        email: "test@example.com",
        name: "Test User",
        password: "SecurePass123!",
      };
// ... (詳細な実装についてはリファレンスガイドを参照)

リファレンスガイド

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

ベストプラクティス

✅ すべき こと

• 統合テストで実際のデータベースを使用する (インメモリまたはコンテナ)
• モックされたレスポンスではなく、実際の HTTP リクエストをテストする
• 操作後のデータベース状態を検証する
• トランザクション境界とロールバックをテストする
• テストに認証・認可を含める
• エラーシナリオとエッジケースをテストする
• 隔離された環境にテストコンテナを使用する
• テスト間でデータをクリーンアップする

❌ すべきでない こと

• 統合テストでデータベース接続をモックする
• エラーパスのテストをスキップする
• テストデータをデータベースに残す
• テストに本番データベースを使用する
• トランザクション管理を無視する
• 成功パスだけをテストする
• テスト間で状態を共有する
• URL や認証情報をハードコードする