Swift 6のTyped throwsを活用する型安全なエラーハンドリング - ローソンデジタルイノベーション　テックブログ

はじめに

iOSエンジニアの申です。今回はエラーハンドリング時に発生した問題とTyped throwsの活用についてご紹介させていただきます。

発生した問題とその原因

エラーが返される可能性がある関数を実行した際にエラーが発生した場合、そのエラーをハンドリングして内容を表示するところでエラー内容が正しく表示されない問題が発生しました。

class MyViewController: UIViewController {
    func handleResponse(result: MyResult?, error: Error?) {
        if let error = error as? CustomError {
            showError(error)  // 期待している通常のエラー処理
        } else if let error = error {
            showError(CommonError.unknown(error))  // 想定外の不明なエラー処理
        } else if let result = result {
            processResult(result)
        }
    }
}

上記は問題が発生したソースをイメージ化したものになります。エラーの内容を表示するshowErrorメソッドにCustomError型のエラーを渡してエラー内容を表示していますが、なぜかerrorの値が設定されている（nilではない）にもかかわらず期待している通常のエラー内容が表示されない状態でした。

この周りを調べた結果、handleResponseに渡されるエラーはCustomError型には変換できずMyError型にしか変換できないエラーでしたのでCustomError型への変換が常に失敗していたのが原因でした。

let customError = error as? CustomError   // 常にnil
let myError = error as? MyError   // MyError型への変換成功

このようなミスはヒューマンエラーによりいつでも発生する可能性がありますが、Swift 6のTyped throwsが防止策の1つになるのではと考えました。

Typed throwsとは？

Swift 6で追加されたTyped throwsは、エラータイプを明示的に指定して投げるようにすることができます。これによりエラーを受け取る側で型変換を行う必要もなくなり、他の型に誤って変換しようとするとコンパイラが検出してアラートを表示します。

enum MyError: Error {
    case invalidNumber
}

enum CustomError: Error {
    case invalidString
}

func convertToInt(_ input: String) throws(MyError) -> Int {  // throwsの右側にエラータイプを指定
    guard let number = Int(input) else {
        throw MyError.invalidNumber
    }
    return number
}

do {
    let result = try convertToInt("abc")
} catch {
    //let myError = error as? MyError  ←受け取る前からMyErrorタイプになっているため、型変換が不要になる
    let customError = error as? CustomError  // ⚠️Cast from 'MyError' to unrelated type 'CustomError' always fails
}

エラーのハンドリング側で型変換が不要になるためソースコードも簡潔になり、エラータイプの変換ミスも防げる効果があります。

doにエラーのタイプを指定することで、catch側でany Errorタイプにならないようにする方法もあります。

enum MyError: Error {
    case invalidNumber
}

enum NetworkError: Error {
    case timeout
    case invalidResponse
}

func fetchData() throws(NetworkError) {
    throw NetworkError.timeout
}

func convertToInt(_ input: String) throws(MyError) -> Int {
    guard let number = Int(input) else {
        throw MyError.invalidNumber
    }
    return number
}

do throws(MyError) {  // doの右側にエラータイプを指定
    let result = try convertToInt("abc")
    try fetchData()  // 🚨Thrown expression type 'NetworkError' cannot be converted to error type 'MyError'
} catch {
    handleError(error)
}