Swift 3シンタックスでカスタムエラータイプを定義しています。localizedDescription
オブジェクトのError
プロパティによって返されるエラーのわかりやすい説明を提供します。どうすればいいの?
public enum MyError: Error {
case customError
var localizedDescription: String {
switch self {
case .customError:
return NSLocalizedString("A user-friendly description of the error.", comment: "My error")
}
}
}
let error: Error = MyError.customError
error.localizedDescription
// "The operation couldn’t be completed. (MyError error 0.)"
localizedDescription
が私のカスタムエラーの説明( "ユーザーフレンドリーなエラーの説明")を返す方法はありますか?ここでのエラーオブジェクトはError
ではなくMyError
型であることに注意してください。もちろん、オブジェクトをMyErrorにキャストすることもできます
(error as? MyError)?.localizedDescription
私のエラータイプにキャストせずにそれを動作させる方法はありますか?
Xcode 8 beta 6リリースノートに記載されているように、
Swift定義のエラータイプは、新しいLocalizedErrorプロトコルを採用することで、ローカライズされたエラーの説明を提供できます。
あなたの場合:
public enum MyError: Error {
case customError
}
extension MyError: LocalizedError {
public var errorDescription: String? {
switch self {
case .customError:
return NSLocalizedString("A user-friendly description of the error.", comment: "My error")
}
}
}
let error: Error = MyError.customError
print(error.localizedDescription) // A user-friendly description of the error.
エラーがNSError
に変換される場合は、さらに多くの情報を提供できます(これは常に可能です)。
extension MyError : LocalizedError {
public var errorDescription: String? {
switch self {
case .customError:
return NSLocalizedString("I failed.", comment: "")
}
}
public var failureReason: String? {
switch self {
case .customError:
return NSLocalizedString("I don't know why.", comment: "")
}
}
public var recoverySuggestion: String? {
switch self {
case .customError:
return NSLocalizedString("Switch it off and on again.", comment: "")
}
}
}
let error = MyError.customError as NSError
print(error.localizedDescription) // I failed.
print(error.localizedFailureReason) // Optional("I don\'t know why.")
print(error.localizedRecoverySuggestion) // Optional("Switch it off and on again.")
CustomNSError
プロトコルを採用することによって、エラーはuserInfo
辞書(およびdomain
とcode
)を提供することができます。例:
extension MyError: CustomNSError {
public static var errorDomain: String {
return "myDomain"
}
public var errorCode: Int {
switch self {
case .customError:
return 999
}
}
public var errorUserInfo: [String : Any] {
switch self {
case .customError:
return [ "line": 13]
}
}
}
let error = MyError.customError as NSError
if let line = error.userInfo["line"] as? Int {
print("Error in line", line) // Error in line 13
}
print(error.code) // 999
print(error.domain) // myDomain
あなたのエラーがこのようなパラメータを持っていれば、私も追加します
enum NetworkError: LocalizedError {
case responseStatusError(status: Int, message: String)
}
ローカライズされた説明でこれらのパラメータを次のように呼び出すことができます。
extension NetworkError {
var errorDescription: String {
switch self {
case .responseStatusError(status: let status, message: let message):
return "Error with status \(status) and message \(message) was thrown"
}
}
このように短くすることもできます。
extension NetworkError {
var errorDescription: String {
switch self {
case let .responseStatusError(status, message):
return "Error with status \(status) and message \(message) was thrown"
}
}
Objective-Cに追加情報を提供するためにエラータイプが採用できるエラー採用プロトコルが2つあります - LocalizedErrorとCustomNSErrorです。これは両方を採用したエラーの例です。
enum MyBetterError : CustomNSError, LocalizedError {
case oops
// domain
static var errorDomain : String { return "MyDomain" }
// code
var errorCode : Int { return -666 }
// userInfo
var errorUserInfo: [String : Any] { return ["Hey":"Ho"] };
// localizedDescription
var errorDescription: String? { return "This sucks" }
// localizedFailureReason
var failureReason: String? { return "Because it sucks" }
// localizedRecoverySuggestion
var recoverySuggestion: String? { return "Give up" }
}
構造体を使用することは代替手段になることができます。静的ローカライゼーションのちょっとした優雅さ:
import Foundation
struct MyError: LocalizedError, Equatable {
private var description: String!
init(description: String) {
self.description = description
}
var errorDescription: String? {
return description
}
public static func ==(lhs: MyError, rhs: MyError) -> Bool {
return lhs.description == rhs.description
}
}
extension MyError {
static let noConnection = MyError(description: NSLocalizedString("No internet connection",comment: ""))
static let requestFailed = MyError(description: NSLocalizedString("Request failed",comment: ""))
}
func throwNoConnectionError() throws {
throw MyError.noConnection
}
do {
try throwNoConnectionError()
}
catch let myError as MyError {
switch myError {
case .noConnection:
print("noConnection: \(myError.localizedDescription)")
case .requestFailed:
print("requestFailed: \(myError.localizedDescription)")
default:
print("default: \(myError.localizedDescription)")
}
}
これはもっと洗練された解決策です:
enum ApiError: String, LocalizedError {
case invalidCredentials = "Invalid credentials"
case noConnection = "No connection"
var localizedDescription: String { return NSLocalizedString(self.rawValue, comment: "") }
}