テストと XCTest

@startuml
Test対象 <.. Test対象が依存しているクラス
Testコード <-left- Test対象:使用
@enduml

@startuml
 interface Test対象が依存 {}
 
 Test対象 <.. Test対象が依存
 
 Test対象 <|- Testコード:使用
 
 Test対象が依存 <|.d. Test対象が依存しているクラス
 
 Test対象が依存 <|.d. Testモック
@enduml

func testMethod() {
    XCTFail()
}

let notNumber = Int("Hello") // 数値に変換できずnil
XCTAssertNil(notNumber)

let number = Int("42") // 数値に変換できInt
XCTAssertNotNil(number)

let string = "Hello"
XCTAssertEqual(string, "Hello") // "Hello"と等しい

let string = "Hello"
XCTAssertNotEqual(string, "Goodbye") // "Goodbye"と等しくない

// プロダクトコード
struct User {
    let name: String
    let age: Int
}

// テストコード
class UserTests: XCTestCase {
    func testInit() {
        let actual = User(name: "foo", age: 10)   // 実際の値
        let expected = User(name: "foo", age: 10) // 期待値
        XCTAssertEqual(actual, expected)
    }
}
 
// プロダクトコードを変更せずに、テストコードのみ Equatable に準拠することも可能
extension User: Equatable {
    static func ==(lhs: User, rhs: User) -> Bool {
        return lhs.name == rhs.name && lhs.age == rhs.age
    }
}

let string = "Hello"
XCTAssertTrue(string.hasPrefix("He")) // "He"から始まる

let string = "Hello"
XCTAssertFalse(string.isEmpty) // 空ではない

// 20 > 10
XCTAssertGreaterThan(20, 10)

// 20 >= 10
XCTAssertGreaterThanOrEqual(20, 10)
XCTAssertGreaterThanOrEqual(20, 20) // 等しくてもOK

// 10 < 20
XCTAssertLessThan(10, 20)

// 10 <= 20
XCTAssertLessThanOrEqual(10, 20)
XCTAssertLessThanOrEqual(10, 10) // 等しくてもOK

XCTAssertThrowsError(try throwError()) // throwError()がなんらかの例外をスローすることを期待

enum APIError: Error {
    case sampleError // なにかしらのエラー
    case anotherError  // 他のエラー
}

// プロダクトコード
struct SampleModel {
    // 例外をスローする可能性がある API リクエスト
    static func fetch() throws {
        // API リクエストの処理...
        if httpStatusCode == 400 {
            throw APIError.anotherError
        }
        if httpStatusCode == 500 {
            throw APIError.sampleError
        }
    }
}

// テストコード
class SampleModelTests: XCTestCase {
    func testFetch() {
        XCTAssertThrowsError(try SampleModel.fetch()) { (error: Error) -> Void in
            // スローされた例外が APIError.sampleError であること
            XCTAssertEqual(error as? DownloadError, APIError.sampleError)
            // XCTAssertTrue(error! is APIError.sampleError)
        }
    }
}

XCTAssertNoThrow(try noThrowError()) // noThrowError()がなにも例外をスローしないことを期待

// プロダクトコード
struct SampleModel {
    // 例外をスローする可能性がある API リクエスト
    static func fetch(@escaping completion: (Result<User, Error>) -> Void) throws {
        // API リクエストの処理...
        // 結果を非同期に返却
        DispatchQueue.main.async {
            completion(.success(user))
        }
    }
}
 
struct User {
    let name: String
    let age: Int
}

// テストコード
class SampleModelTests: XCTestCase {
    func testFetch() {
        // 処理を待機させる
        let exp: XCTestExpectation = expectation(description: "wait for finish")
 
        SampleModel.fetch { (result: Result<User, Error>) in
            switch result {
            case .success(let data):
                XCTAssertEqual(data.agentId, 123)
            case .failure(let error):
                XCTFail("error: \(error)")
            }
 
            // expの待機を解除
            exp.fulfill()
        }
 
        // exp.fulfill()が実行されるまで、5秒間待機する
        wait(for: [exp], timeout: 5)
    }
}