なぜUnitTestが書けないのか？〜今日から始める品質改善：応用編(モック利用)〜

// ユーザーリポジトリ（テスト対象）
class UserRepository {
    // APIクライアントへの依存
    // 【①】解説：UserRepositoryが具体的なRealAPIClientではなく、抽象的なAPIClientに依存しているので、
    //      テスト時にモックを簡単に注入できます。（「融通が利く」「柔軟に対応できる」状態）
    private let apiClient: APIClient

    init(apiClient: APIClient) {
        self.apiClient = apiClient
    }

    func getUser(id: Int) async throws -> User {
        let data = try await apiClient.fetch(path: "/users/\(id)")
        // APIのレスポンスからUserオブジェクトを生成する処理
        guard let json = try JSONSerialization.jsonObject(with: data) as? [String: Any],
              let id = json["id"] as? Int,
              let name = json["name"] as? String else {
            throw APIError.invalidResponse
        }
        return User(id: id, name: name)
    }
}

// APIクライアントのプロトコル
protocol APIClient {
    func fetch(path: String) async throws -> Data
}

// 本物のAPIクライアント（ここでは簡略化）
class RealAPIClient: APIClient {
    func fetch(path: String) async throws -> Data {
        // 実際のAPI呼び出しを行う処理
        // 例: URLSession.shared.data(from: url)
        // 今回は実装を省略
        print("RealAPIClient: APIを呼び出しています (\(path))")
        return Data() // 仮の空のDataを返す
    }
}

// ユーザー情報
struct User {
    let id: Int
    let name: String
}

// APIエラー
enum APIError: Error {
    case invalidResponse
}


// モックAPIクライアント：解説②
// 【②】解説：fetchメソッドは、事前に設定されたmockDataまたはmockErrorを返すように動作します。
class MockAPIClient: APIClient {
    var mockData: Data?
    var mockError: Error?

    func fetch(path: String) async throws -> Data {
        if let error = mockError {
            throw error
        }
        return mockData ?? Data()
    }
}

import XCTest
@testable import YourProjectName // プロジェクト名に合わせて変更

final class UserRepositoryTests: XCTestCase {

    func testGetUser_Success() async throws {
        // モックAPIクライアントの準備（正常系データを設定）
        let mockAPIClient = MockAPIClient()
        mockAPIClient.mockData = """
        {
            "id": 123,
            "name": "John Doe"
        }
        """.data(using: .utf8)! // テスト用のJSONデータ

        // UserRepositoryの初期化（モックAPIクライアントを注入）
        // 【③】解説：これは「依存性の注入」と呼ばれる方法で、
        // 疎結合な状態(UserRepositoryが具体的なRealAPIClientではなく、抽象的なAPIClientに依存している)のため実現できています。
        // もしも密結合な状態（UserRepositoryがRealAPIClientに直接依存する形）だった場合、
        // UserRepositoryをテストするためには、実際にAPIを呼び出す必要があり、
        // UnitTestで RealAPIClient の代わりに MockAPIClient を使用することができません。
        let userRepository = UserRepository(apiClient: mockAPIClient)

        // テスト対象のメソッドを実行
        let user = try await userRepository.getUser(id: 123)

        // 結果の検証
        XCTAssertEqual(user.id, 123)
        XCTAssertEqual(user.name, "John Doe")
    }

    func testGetUser_InvalidResponse() async throws {
        // モックAPIクライアントの準備（無効なJSONデータを設定）
        let mockAPIClient = MockAPIClient()
        mockAPIClient.mockData = """
        {
            "invalid": "data"
        }
        """.data(using: .utf8)!

        // UserRepositoryの初期化（モックAPIクライアントを注入）
        // 【③】解説：正常系と同じ考え方です
        let userRepository = UserRepository(apiClient: mockAPIClient)

        // エラーが発生することを確認
        await XCTAssertThrowsErrorAsync(try await userRepository.getUser(id: 123)) { error in
            XCTAssertEqual(error as? APIError, APIError.invalidResponse)
        }
    }
}

// async/await環境でのXCTAssertThrowsError
// ※XCTestにはasync/await環境でエラーが発生することを検証する
// XCTAssertThrowsErrorのasync版が用意されていないため、拡張関数として定義
func XCTAssertThrowsErrorAsync<T>(
    _ expression: @autoclosure () async throws -> T,
    _ message: @autoclosure () -> String = "",
    file: StaticString = #filePath,
    line: UInt = #line,
    _ errorHandler: (_ error: Error) -> Void = { _ in }
) async {
    do {
        _ = try await expression()
        XCTFail("No error thrown", file: file, line: line)
    } catch {
        errorHandler(error)
    }
}