Swift Errorプロトコルの作り方｜独自エラー型の設計

1. SwiftのErrorプロトコルとは？

1. SwiftのErrorプロトコルとは？

Swiftでは、「エラーとして扱える型かどうか」を判断するためにErrorプロトコルが使われています。簡単に言うと、Errorに準拠していれば、その型はthrowやcatchで使える“公式なエラー”になります。

プロトコルとは「こういう役割を持つ型ですよ」とSwiftに伝えるための約束事のようなものです。Errorプロトコル自体には難しい処理はなく、「エラー用の型ですよ」と示すための目印だと考えて大丈夫です。

たとえば、プログラミング未経験の方でもイメージしやすい例として、次のような最小限のエラー型を作れます。

enum SimpleError: Error {
    case somethingWrong
}

たったこれだけで、SimpleErrorはSwiftに「これはエラーです」と認識されます。標準ライブラリのエラーも、実は同じErrorプロトコルを使って作られており、私たちはそれと同じ仕組みを利用して独自エラーを定義できるのです。

2. 独自エラー型を作る基本

2. 独自エラー型を作る基本

Swiftでエラーを自分で定義したいとき、まず覚えておきたいのがenum（列挙型）を使う方法です。enumは「決められた選択肢の中から1つを表す」仕組みなので、起こりうるエラーの種類を整理して表現するのにとても向いています。

たとえば「ファイルを扱う処理」では、ファイルが存在しない、操作する権限がない、原因がよく分からない、などいくつかの失敗パターンが考えられます。これらをenumでまとめておくと、後からコードを読んだときにも状況が分かりやすくなります。

enum FileError: Error {
    case notFound      // ファイルが見つからない
    case noPermission  // 操作する権限がない
    case unknown       // その他のエラー
}

このように書くことで、FileErrorはSwiftが認識できる「エラー型」になります。: Errorを付けている点が重要で、「これはエラーとして使いますよ」と明示しています。

プログラミング未経験の方は、「失敗の種類に名前を付けて箱にまとめている」とイメージすると理解しやすいでしょう。あとからエラーを処理するときに、「どの失敗が起きたのか」を安全に判断できるのが、独自エラー型を作る大きなメリットです。

3. throwで独自エラーを投げる

3. throwで独自エラーを投げる

Swiftでは、問題が起きたことをプログラムに伝えるためにthrowを使います。これは「ここでエラーが発生しました」と知らせる合図のようなものです。自分で定義した独自エラーも、条件に応じて自由に投げることができます。

たとえば、ファイル名を受け取ってファイルを開く処理を考えてみましょう。ファイル名が空だったり、開いてはいけないファイルだった場合は、正常に処理を続けるのではなく、エラーとして扱ったほうが安全です。

func openFile(name: String) throws {
    if name == "" {
        // ファイル名が指定されていない場合のエラー
        throw FileError.notFound
    }
    if name == "secret.txt" {
        // 権限がなく開けない場合のエラー
        throw FileError.noPermission
    }
    print("ファイルを開きました")
}

このようにthrowを書くことで、「この条件のときはエラーにする」というルールをはっきりさせられます。初心者のうちは、throwは「失敗したらここで処理を止めて知らせるもの」と覚えておくと理解しやすいです。

4. do-catchで独自エラーを処理する

4. do-catchで独自エラーを処理する

投げられた独自エラーは、呼び出し側でdo-catchを使って捕まえます。

do {
    try openFile(name: "secret.txt")
} catch FileError.notFound {
    print("ファイルが見つかりません")
} catch FileError.noPermission {
    print("権限がありません")
} catch {
    print("その他のエラー: \(error)")
}

権限がありません

特定のケースごとに分岐できるので、ユーザーに適切なメッセージを表示できます。

5. 構造体やクラスでも独自エラー型を作れる

5. 構造体やクラスでも独自エラー型を作れる

enumだけでなく、struct（構造体）やclass（クラス）を使って独自エラーを作ることも可能です。より詳細な情報を持たせたいときに便利です。

struct NetworkError: Error {
    let code: Int
    let message: String
}

例えば「エラーコード」や「説明文」を持たせれば、開発者やユーザーにとって分かりやすいエラー表示が可能になります。

6. 独自エラー型を使うメリット

6. 独自エラー型を使うメリット

独自エラー型を設計するメリットは以下の通りです。

• エラーの種類を明確に分けられる。
• ユーザーに分かりやすいメッセージを表示できる。
• 開発者が原因を特定しやすくなる。
• アプリの信頼性を高められる。

特にアプリ開発では「何が原因でエラーになったのか」を明確にすることが、トラブル解決やユーザー体験の向上につながります。

7. 現実的な利用シーン

7. 現実的な利用シーン

独自エラー型は、例えば以下のような場面でよく使われます。

• ネットワーク通信（接続失敗、タイムアウト、無効なレスポンスなど）
• データベース操作（データが見つからない、保存失敗など）
• ファイル操作（読み込み権限なし、書き込み失敗など）

これらの場面でErrorプロトコルを活用すれば、アプリがエラーに強くなり、ユーザーにも親切な挙動を実現できます。

まとめ

まとめ

Swift Errorプロトコルの作り方では、Errorプロトコルの作り方をSwiftで扱うときの考え方を確認しました。Swiftは、書き方だけを覚えるよりも、Xcodeで動かしながら「どこで値が変わるのか」「失敗したときに何が起きるのか」を見たほうが理解しやすくなります。

復習するときは、次のような短いコードを自分の環境で動かしてみましょう。記事のテーマに合わせて値や条件を変えると、Swiftの型安全、Optional、エラー処理、画面更新の見え方が少しずつ整理できます。

struct LearningStep {
    let title: String
    let completed: Bool
}

let steps = [
    LearningStep(title: "文法を確認する", completed: true),
    LearningStep(title: "サンプルを動かす", completed: false)
]

print(steps.filter { !$0.completed })