統合テストとは何ですか？

Question

統合テストとは何ですか？

Accepted Answer

**統合テスト**は、複数の**コンポーネントまたはユニットが正しく連携して動作すること**を検証します。これらのテストは、相互作用と統合ポイント（コードとデータベースの連携、サービス間の呼び出し、モジュール結合など）をテストします。ユニットテスト（ユニットを分離してテスト）が見つけられない問題をキャッチします。

## 統合テストが検証すること

```text
Integration tests verify COMPONENTS WORKING TOGETHER (not in isolation):
  → code + DATABASE (does the data layer actually work with a real DB?)
  → service A calling service B / an external API
  → multiple modules/units combined; the integration POINTS between them
→ catches issues in how parts INTERACT — which unit tests (isolated) can't catch.
```

## 統合テストが重要な理由（ユニットテストとの比較）

```text
UNIT tests isolate units (mocking dependencies) → fast, but DON'T verify real integration:
  → a unit can pass its tests but FAIL when combined (wrong assumptions about a dependency,
    a real DB query that's wrong, an API contract mismatch, config issues)
INTEGRATION tests use REAL (or realistic) dependencies → catch these interaction bugs:
  → wiring/configuration errors, data layer issues, contract mismatches between components
→ Integration tests verify the parts actually work TOGETHER.
```

## 例と考慮事項

```js
// integration test: the repository actually works with a (test) database
test('UserRepository saves and retrieves a user', async () => {
  const repo = new UserRepository(testDb);     // REAL test database
  await repo.save({ name: 'Ann' });
  const user = await repo.findByName('Ann');    // real query
  expect(user.name).toBe('Ann');
});
```

```text
→ SLOWER than unit tests (real I/O, setup); use a TEST database/environment
→ Test important integration points (data access, key service interactions, APIs)
→ Fewer than unit tests (the pyramid middle); manage test data/state carefully
```

## なぜ重要なのか

統合テストを理解することは重要です。なぜなら、**ユニットテストでは検出できないバグのクラスをキャッチするため**です。つまり、コンポーネント同士がどのように連携するかに関する問題です。したがって、包括的なテストに関する貴重な知識となります。

ユニットテストは個別のユニットを分離してテストします（依存関係をモック化）。しかし、この分離は**実際の統合を検証できない**ことを意味します。ユニットがすべてのテストに合格しても、実際に他のコンポーネントと組み合わせると失敗する可能性があります（依存関係についての間違った仮定、実際のデータベースクエリの誤り、APIコントラクトの不一致、または設定の問題が原因）。**統合テスト**はこのギャップを埋めます。実際の（またはリアルな）依存関係を持つ**コンポーネント同士の連携をテストすることで**、コードが実際のデータベースで動作し、サービスが正しく相互作用し、統合ポイントが機能することを検証します。これにより、分離されたユニットテストが見つけられない配線、データレイヤー、およびコントラクトのバグをキャッチできます。

この補完的な関係（分離されたロジックのためのユニットテスト、実際の相互作用のための統合テスト）を理解することは、包括的なテストの鍵です。なぜなら、単独ではどちらも十分ではないからです。

**考慮事項**を理解すること（統合テストは遅い（実際のI/Oとセットアップがあり、ピラミッドの中間に位置するためユニットテストより少ない）、テストデータベース/環境を使用する、重要な統合ポイント（データアクセス、重要なサービス相互作用、API）に焦点を当てる、慎重なテストデータ/状態管理を必要とする）は、実践的な統合テストを反映しています。

統合テストは、組み立てられたパーツが機能することについて信頼性を提供します。これはユニットテストだけでは得られません。

実際のアプリケーションは相互作用するコンポーネントで構成されており、統合バグ（データベース問題、コントラクト不一致、設定エラー）は一般的でありユニットテストでは見落とされるものだからです。また、統合テストは、コンポーネント同士が連携することを検証することでそれらをキャッチするため、統合テストを理解することは貴重で実践的に関連のある知識です。これはユニットテストに不可欠な補完となり、分離されたユニットだけでなく、システムのパーツが実際に正しく連携して動作することを検証する包括的なテストに重要です。