在 iOS 上处理错误

Swift 内置了对在运行时抛出和捕获可恢复错误的支持。例如，如果代码中的某项操作失败或无效，API 会抛出 HomeError 错误。这样一来，您只需专注于可恢复的错误，从而简化并优化了错误处理流程。然后，您可以提供选项，例如让用户重试或显示“未找到结构”等消息。由于您不必明确处理每种可能的异常，因此代码不会过于杂乱，从而可以更专注于其主要用途。

可恢复性故障的处理示例：

    let light1 = lightDevices.first
    if let light = light1 {
    do {
      try await structure.move(device: light, to: room)
    } catch let error as HomeError {
      // Code for handling the exception
    }

下表提供了您可能会遇到的 HomeError 代码的含义：

表：HomeError 代码

代码	含义
aborted	操作已中止。当出现并发问题（例如序列检查失败或事务中止）时，通常会显示此错误。
alreadyExists	您尝试创建的资源或实体已存在。 例如，这可以是温控器的命名时间表。
cancelled	操作已取消（通常是被调用者取消）。
dataLoss	数据丢失或损坏且不可恢复。
deadlineExceeded	在操作完成之前截止期限已过。对于更改系统状态的操作，即使操作已成功完成，也可能会返回此错误。例如，服务器的成功响应延迟时间过长，截止期限已过。
failedPrecondition	操作被拒绝，因为系统未处于执行该操作所需的状态。例如，如果您对已停止的烤箱调用 stop，可能会收到此消息。
internal	内部错误。这意味着底层系统所期望的一些不变量已损坏。此错误代码保留用于严重错误。
invalidArgument	客户端指定了无效参数。请注意，这与 `failedPrecondition` 不同。`invalidArgument` 表示无论系统状态如何，都有问题的实参（例如，文件名格式错误）。
notFound	您指定的实体或资源找不到。例如，在媒体播放器设备上调用 play 时指定不存在的轨道 ID。
outOfRange	某个形参超出了有效范围（根据当前系统状态）。当值在 API 调用可能接受的值范围内，但在当前上下文中没有意义时，系统会显示此消息。
permissionDenied	您无权执行指定的操作。此错误代码不应被解读为表示相应请求在其他方面有效。
resourceExhausted	某项资源已用尽。例如，当在宠物喂食器设备上调用 dispense(item:amount:unit:presetName:) 时，如果设备中没有剩余食物，则可能会抛出此异常。
unauthenticated	无法识别调用方，或者请求没有有效的身份验证凭据。
unavailable	服务不可用。这很可能是一种暂时性情况，可以通过退避重试来纠正。请注意，重试执行非幂等操作并非总是安全的。
unimplemented	所请求的操作在此服务中未实现、不受支持或未启用。
unknown	未知错误。一般来说，当出现无法使用任何其他错误代码进行分类的错误情况时，系统会显示 unknown。例如，当从外部 API 接收到的状态值缺少有关根本原因的足够信息时，可能会返回此错误。