Swift错误处理
hudson 译 原文
处理应用程序中的错误和意外值可以说与处理有效结果一样重要。让我们看看一些关键技术,这些技术可以帮助我们在代码中遇到错误时提供更好的用户体验。
Swift提供了一种使用Error
协议定义和处理错误的原生方法。符合它不需要添加任何特定的属性或方法,因此我们可以轻松地使任何类型符合它------例如下面的枚举,该枚举包含一些在验证字符串值时可能遇到的不同错误:
swift
enum ValidationError: Error {
case tooShort
case tooLong
case invalidCharacterFound(Character)
}
使用上述错误枚举,我们现在可以编写一个简单的函数,验证给定的username
用户名不是太长或太短,并且它不包含任何非字母字符。为此,我们将把函数标记为能够使用throws
抛出错误,并在不满足验证要求的情况下使用throw
关键字触发错误------像这样:
swift
func validate(username: String) throws {
guard username.count > 3 else {
throw ValidationError.tooShort
}
guard username.count < 15 else {
throw ValidationError.tooLong
}
for character in username {
guard character.isLetter else {
throw ValidationError.invalidCharacterFound(character)
}
}
}
由于用throws
标记了上述函数, 现在需要在其调用前加上try
关键字------这反过来又迫使我们处理从它抛出的任何错误(或使用try?
将其返回值转换为可选值)。例如,在这里,使用上述函数来验证用户刚刚选择的用户名,如果验证通过(没有抛出错误),则继续将该用户名提交给服务器------否则使用UILabel
显示遇到的错误:
swift
func userDidPickName(_ username: String) {
do {
try validate(username: username)
// If we reach this point in the code, then it means
// that no error was thrown, and the validation passed.
submit(username)
} catch {
// The variable 'error' is automatically available
// inside of 'catch' blocks.
errorLabel.text = error.localizedDescription
}
}
但是,如果我们以无效的用户名作为输入(如"john-sundell")运行上述代码,errorLable
中将显示一条非常晦涩的错误消息:
The operation couldn't be completed. (App.ValidationError error 0.)
上述信息会让用户感到困惑。既没有可行动的信息,还向用户暴露了实现细节(例如错误类型的名称)。
解决方案是启用错误类型本地化。为此,扩展ValidationError
以符合LocalizedError
,这是Error
协议的专门版本。通过实现其errorDescription
属性------我们现在可以为每个错误情况返回适当的本地化消息:
swift
extension ValidationError: LocalizedError {
var errorDescription: String? {
switch self {
case .tooShort:
return NSLocalizedString(
"Your username needs to be at least 4 characters long",
comment: ""
)
case .tooLong:
return NSLocalizedString(
"Your username can't be longer than 14 characters",
comment: ""
)
case .invalidCharacterFound(let character):
let format = NSLocalizedString(
"Your username can't contain the character '%@'",
comment: ""
)
return String(format: format, String(character))
}
}
}
随着上述更改到位,之前的验证错误现在将以更友好的方式显示:
Your username can't contain the character '-'
好多了👍。好消息是,在处理异步错误时,我们也可以应用许多相同的技术。到目前为止,我们只以完全同步的方式处理错误和抛出函数------上面使用的do、try、catch
模式对此非常出色------但当涉及到异步代码时,错误通常会传递给一个完成处理程序,而不是抛出。
例如,假设我们想使validate
函数异步------也许能够进行网络绑定验证,或者在后台线程上执行更复杂的规则。为此需要转换函数签名,如下:
swift
func validate(username: String,
then handler: @escaping (ValidationError?) -> Void) {
...
}
由于错误现在作为可选值传递给handler
闭包,我们必须使用略微不同的策略来捕获它们。谢天谢地,这只是一个解包可选值的问题,并使用相同的localizedDescription
属性来访问本地化的错误消息------而不是使用catch
块:
swift
func userDidPickName(_ username: String) {
validate(username: username) { error in
if let error = error {
errorLabel.text = error.localizedDescription
} else {
submit(username)
}
}
}
花一点额外的时间为应用程序添加适当的错误处理,可以真正提高其感知质量。没有人喜欢被卡在屏幕上,上面有一条晦涩的错误信息,该错误信息没有真正说明什么,也没有提供任何形式的建议来纠正错误。通过在错误类型中添加本地化,以及一些代码来处理和显示这些错误,可以让用户感觉更好------即使出了问题。
谢谢你的阅读!