Swiftでエラーをテスト！XCTestとthrowsを使った検証方法を初心者向けに解説

Swift テストでエラーを検証する｜XCTestとthrowsの活用

先生と生徒の会話形式で理解しよう

生徒

「先生、Swiftのエラーハンドリングを勉強しているんですが、テストでエラーが出るかどうかを確認する方法ってあるんですか？」

先生

「はい、SwiftにはXCTestというテスト用のフレームワークが用意されていて、エラーを投げる関数（throws）を検証できます。」

生徒

「throwsっていうのは、エラーを投げる関数のことでしたよね？」

先生

「そうです。今日はXCTestとthrowsを組み合わせて、エラーを正しく検証する方法を一緒に学んでいきましょう。」

1. XCTestとは？

XCTestはAppleが提供する公式のテストフレームワークで、Xcodeに標準で組み込まれています。初心者に分かりやすく説明すると、アプリを作るときに「ちゃんと正しく動いているか」を自動でチェックしてくれる仕組みです。

手動でアプリを動かして確認するのは大変ですが、テストを自動化することで効率よくバグを防げます。

2. throwsとエラー処理のおさらい

throwsはSwiftの関数で「エラーを投げる可能性がある」という意味を持ちます。呼び出す側ではtryを付けて実行し、エラーが出た場合はcatchで処理できます。

例えば次のような関数を考えてみましょう。


enum MathError: Error {
    case divideByZero
}

func divide(_ a: Int, by b: Int) throws -> Int {
    guard b != 0 else {
        throw MathError.divideByZero
    }
    return a / b
}

この関数は「0で割ろうとしたらエラーを投げる」仕様になっています。

3. XCTestでthrowsをテストする

XCTestにはXCTAssertThrowsErrorという便利な関数があり、指定した処理がエラーを投げるかどうかを確認できます。


import XCTest

final class MathTests: XCTestCase {
    func testDivideByZero() {
        XCTAssertThrowsError(try divide(10, by: 0)) { error in
            XCTAssertEqual(error as? MathError, MathError.divideByZero)
        }
    }
}

このテストでは「0で割るとエラーが発生する」ことを確認しています。また、どのエラーが投げられたのかも検証しています。

4. エラーが発生しないことを確認する

逆に「エラーが出ないこと」を確認したい場合は、XCTAssertNoThrowを使います。


func testDivideSuccess() {
    XCTAssertNoThrow(try divide(10, by: 2))
}

これにより、通常のケースではエラーが発生しないことを保証できます。

5. テストコードの役割と初心者へのポイント

テストは「失敗するケース」と「成功するケース」の両方を書くことが大切です。特にエラーハンドリングでは、異常系の動作を確認することが重要になります。

初心者の方はまず「エラーが発生する状況をテストで再現してみる」ことから始めると理解が深まります。

Swiftを基礎から実践レベルまで学びたい人や、 iOSアプリ開発を本格的に始めたい人には、定番の入門＋実践書がこちらです。

Swift実践入門をAmazonで見る

※ Amazon広告リンク

6. ベストプラクティス

SwiftでXCTestとthrowsを活用してエラー検証を行う際のベストプラクティスは以下の通りです。

発生しうるエラーごとにテストを書く
想定外のエラーが出ないことも確認する
テスト名を分かりやすくする（例：testDivideByZero）
エラーの内容を具体的に検証する

こうすることで、アプリの信頼性を高め、安心して機能を追加できるようになります。

Windowsで始めるiPhoneアプリ開発入門｜Swiftの基本と仕組みを1時間で攻略

「iPhoneアプリを作りたいけれど、Macを持っていないから諦めている」そんな方のための画期的な入門講座です。実は、プログラミングの本質を学ぶのに高価な機材は必要ありません。本講座では、Windowsパソコンを使用し、クラウド環境を活用してAppleの最新言語Swift（スウィフト）の基礎を最短距離でマスターします。