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 codes
程式碼 意義
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 收到的狀態值缺乏足夠的根本原因資訊時，就可能傳回此錯誤。