在 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 收到的状态值缺少有关根本原因的足够信息时，便会返回此错误。