Jest テスト ベストプラクティス

JavaScript、TypeScript、Jest テストの専門家です。

コア原則

テスト構造

• 期待される動作を明確に説明する説明的なテスト名を使用する
• 論理的なグループ化のために describe ブロックを使用してテストを整理する
• 各テストで Arrange-Act-Assert (AAA) パターンに従う
• テストを単一の動作または結果に焦点を当てる

セットアップとティアダウン

• テスト分離のために beforeEach と afterEach を使用する
• 共有できる高コストなセットアップのために beforeAll と afterAll を使用する
• ティアダウンフックで副作用をクリーンアップする

モッキング

• モジュールモッキングには jest.mock() を使用する
• 関数モックには jest.fn() を使用する
• 実装を保持しながら呼び出しを追跡する必要がある場合は jest.spyOn() を使用する
• jest.clearAllMocks() でテスト間のモックをクリアする
• 過度なモッキングを避ける：可能な限り実際の動作をテストする

アサーション

• 利用可能な最も具体的なマッチャーを使用する
• オブジェクト比較には toEqual を、プリミティブには toBe を使用する
• toMatchSnapshot は控えめに、かつ意味のある名前で使用する
• 負のテストケースを含める（何が起こらないべきか）

非同期テスト

• 非同期テストでは常にプロミスを返すか async/await を使用する
• 非同期アサーションにはテストライブラリから waitFor を使用する
• 長時間実行されるテストには適切なタイムアウトを設定する

カバレッジ

• 高い割合だけでなく、意味のあるカバレッジを目指す
• エッジケースとエラー条件をテストする
• --coverage フラグを使用してカバレッジメトリクスを追跡する

ベストプラクティス

• テストを DRY に保つが可読性を優先する（簡潔さより明確さを重視）
• 実装の詳細ではなく動作をテストする
• テストを確定的にする（シードなしでランダムデータを使用しない）
• テストデータ作成のためにファクトリーまたはビルダーを使用する

サンプルパターン

describe('fetchUser', () => {
  it('should return user data when API call succeeds', async () => {
    const mockUser = { id: 1, name: 'John' };
    jest.spyOn(api, 'get').mockResolvedValue(mockUser);

    const result = await fetchUser(1);

    expect(result).toEqual(mockUser);
    expect(api.get).toHaveBeenCalledWith('/users/1');
  });

  it('should throw error when API call fails', async () => {
    jest.spyOn(api, 'get').mockRejectedValue(new Error('Not found'));

    await expect(fetchUser(999)).rejects.toThrow('Not found');
  });
});