Swiftでテストダブル(Mock/Stub)をprotocolで設計する方法を初心者向けに解説！

1. テストダブル(Mock/Stub)とは？

1. テストダブル(Mock/Stub)とは？

まず、テストダブルとは本物の代わりに使う「ダミーの役者」のことです。サッカーの試合で、練習のときに本物の審判の代わりに先生がジャッジするようなものです。

Stub（スタブ）は「決まった返事をする代役」。例えば「必ず成功を返すサーバーの代わり」として使います。

Mock（モック）は「呼ばれたかどうか、何回呼ばれたか」を記録できる代役。テストで「本当にこの処理を呼んだのか？」を確認するために使います。

2. protocolで設計するメリット

2. protocolで設計するメリット

テストダブルを作るとき、protocolを使うととても便利です。なぜなら、protocolは「ルール」を定義するだけで、実際の中身を入れ替えることができるからです。つまり、本番用の実装とテスト用の代役を自由に差し替えられるのです。

例えば、データを取得するサービスをprotocolで表現しておくと、本番では本物のAPI通信を、テストではスタブやモックを用意できます。

3. Stubをprotocolで作る例

3. Stubをprotocolで作る例

まずはStubの例を見てみましょう。決まった返答を返すだけの代役です。

protocol UserService {
    func fetchUserName() -> String
}

struct RealUserService: UserService {
    func fetchUserName() -> String {
        // 実際にはサーバー通信など
        return "本物のユーザー名"
    }
}

struct StubUserService: UserService {
    func fetchUserName() -> String {
        return "テスト用ユーザー"
    }
}

テストではStubUserServiceを使うことで、サーバーに接続しなくても「テスト用ユーザー」という名前が返ってきます。

4. Mockをprotocolで作る例

4. Mockをprotocolで作る例

次にMockの例です。呼ばれた回数や内容を記録できます。

class MockUserService: UserService {
    private(set) var callCount = 0

    func fetchUserName() -> String {
        callCount += 1
        return "モックユーザー"
    }
}

// テスト例
let mock = MockUserService()
let name = mock.fetchUserName()
print(name)          // "モックユーザー"
print(mock.callCount) // 1

モックユーザー
1

これで「fetchUserName()が1回呼ばれた」ということを確認できます。もし想定と違えばテストが失敗する仕組みを作れます。

5. 現実世界の例えで理解する

5. 現実世界の例えで理解する

学校での練習試合を想像してください。本番の試合では本物の審判や観客がいますが、練習では「先生が審判役」をしても問題ありません。先生が「必ずOKを出す」ならそれはStubです。「どのプレーに何回笛を吹いたか」を数えるならMockです。どちらも本物の代役ですが、役割が少し違うのです。

Swiftでprotocolを使えば、このような「本番の代わり」を簡単に作り分けることができます。

6. 初心者が意識すべきポイント

6. 初心者が意識すべきポイント

初心者の方は、まず「本番用の処理」と「テスト用の処理」を分ける習慣を意識しましょう。protocolを使えば、処理の切り替えが簡単になり、テストもしやすくなります。実際のアプリ開発では「ネットワーク通信」「データベース保存」「外部サービス呼び出し」などにテストダブルをよく使います。

特にアプリが大きくなればなるほど、モックやスタブを正しく設計することが、品質を守る大切なポイントになります。