実務で使ってないし...
どれほど便利か分からないし...

そう思ってテストコード書いたことない方へ！

改めて基礎を学んだら意外とスムーズに理解できるので、Swiftのテストコード基本知識をまとめてみました！

Swiftのテストコード　＝　XCTest(フレームワーク)

と思ってもらってOKらしいです。

🤭Swift6.0からTestingという新たなフレームワークも出ましたがまずはXCTestをサクッと学ぼう！
Testing

XCTestを使うと、手動で動作確認しなくても、自動でコードの動作をチェックできるようになります。

本記事では、XCTestの基本を解説しながら、実際のコード例も交えて紹介します。

XCTestとは？

XCTestは、Appleが提供する単体テストのためのフレームワークです。

✅ アプリのバグを早く見つける → 手動で動かさなくてもチェックできる
✅ 修正による影響を防ぐ → 変更した部分が他に影響を与えていないか確認できる
✅ 安心して開発できる → 自動テストがあれば、新しい機能を追加するときも安心！

では、早速 XCTestの基本的な使い方を見ていきましょ！

XCTestの基本構成

Swiftのテストを書くには、XCTestCase を継承したクラスを作ります。

基本の流れは次の通り：

1. テストクラスを作成する
2. 初期化テストメソッドを書く
3. XCTAssertで結果をチェックする

1.テストクラスを作成する

Swift(UI)アプリを作ると、自動でテスト用のファイルを生成できます。例えば、MyAppTests.swift というファイルがあった場合、こんな感じのコードが入っています。

自動で作成せずとも後から自分で作成することもできますよ！

import XCTest
@testable import MyApp  // 自分のアプリのコードをテストできるようにする

final class MyAppTests: XCTestCase {
    override func setUp() {
        // 各テストの前に呼ばれる
        super.setUp()
    }

    override func tearDown() {
        // 各テストの後に呼ばれる
        super.tearDown()
    }

    func testExample() {
        // ここにテストを書く
    }
}

2.初期化テストメソッドを書く

基本的にoverrideメソッドは以下２つ。

setUp

override func setUp() {
    super.setUp()
    // 各テストが実行される前に呼ばれる
}

テストの前に準備をするメソッドです。
例えば、データを初期化したり、テスト用のオブジェクトを作成するのに使います。

tearDown

override func tearDown() {
    // 各テストが終わった後に呼ばれる
    super.tearDown()
}

テストが終わった後に後片付けをするメソッドです。
例えば、一時ファイルを削除したり、メモリを開放する処理を入れます。

3.XCTAssertで結果をチェックする

テストでは、XCTAssert を使って値をチェックします。
基本はXCTAssert◯◯◯メソッドで判定します。(XCTFailは例外！)

1.XCTAssertEqual（値が等しいかチェック）

XCTAssertEqual(2 + 3, 5)  // OK
XCTAssertEqual("Hello", "hello")  // NG（大文字・小文字が違う）

「左と右の値が等しいか？」をチェックします。

2.XCTAssertNotEqual（値が異なるかチェック）

XCTAssertNotEqual(2 + 3, 6)  // OK（5と6は違う）

「左と右の値が違うか？」を確認します。

3.XCTAssertTrue（条件がtrueか？）

let isUserLoggedIn = true
XCTAssertTrue(isUserLoggedIn)  // OK

「この値はtrueか？」をチェックします。

4.XCTAssertFalse（条件がfalseか？）

let isUserLoggedIn = false
XCTAssertFalse(isUserLoggedIn)  // OK

「この値はfalseか？」をチェックします。

5.XCTAssertNil（値がnilか？）

let value: String? = nil
XCTAssertNil(value)  // OK

「この値はnilか？」を確認します。

6.XCTAssertNotNil（値がnilでないか？）

let value: String? = "Hello"
XCTAssertNotNil(value)  // OK

「この値はnilでないか？」を確認します。

7.XCTFail（失敗を強制する）

XCTFail("このテストは失敗する")

このメソッドを実行すると、必ずテストが失敗します。
「ここに来るべきではない」といったケースをチェックするのに使います。

実際にテストを書いてみよう！

例として、「文字列を逆にする関数」を作って、それをテストしてみます。

まず、StringReverser というクラスを作ります。

class StringReverser {
    func reverse(_ input: String) -> String {
        return String(input.reversed())
    }
}

次に、この関数が正しく動くかチェックする XCTestを書きます。

import XCTest
@testable import MyApp  // 自分のアプリのコードをテストできるようにする

final class StringReverserTests: XCTestCase {
    var reverser: StringReverser!
    
    override func setUp() {
        super.setUp()
        reverser = StringReverser()
    }
    
    override func tearDown() {
        reverser = nil
        super.tearDown()
    }
    
    func testReverse() {
        let result = reverser.reverse("Hello")
        XCTAssertEqual(result, "olleH", "Hello を逆にすると olleH にな！")
    }
}

これを実行すると…
✅ Hello を逆にすると olleH になるかチェックしてくれます！

まとめ

XCTestを使うと、Swiftのコードを自動でテストできる！

✅ setUp はテストの前に準備する
✅ tearDown はテストの後に後片付けをする
✅ XCTAssertを使って、値をチェックできる

Future Work

新しいApple純正テストフレームワークを使ってみたい未来の自分用メモ
Apple Document - Testing

Quiita記事