Tratamento de erros no iOS

O Swift oferece suporte integrado para gerar e capturar erros recuperáveis no tempo de execução. Por exemplo, se uma operação no código falhar ou não for válida, a API vai gerar um erro HomeError. Isso simplifica e agiliza o tratamento de erros, permitindo que você se concentre apenas em erros recuperáveis. Você pode oferecer opções, como permitir que o usuário tente novamente ou mostrar uma mensagem como "Estrutura não encontrada". E como você não precisa processar explicitamente todas as exceções possíveis, seu código fica menos confuso e, consequentemente, permanece mais focado no objetivo principal.

Exemplo de como lidar com uma falha recuperável:

    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
    }

A tabela a seguir mostra o significado dos códigos HomeError que você pode encontrar:

Tabela: códigos HomeError
Código Significado
aborted A operação foi interrompida. Isso geralmente aparece quando há um problema de simultaneidade, como falha na verificação da sequência ou cancelamento da transação.
alreadyExists O recurso ou a entidade que você está tentando criar já existe. Por exemplo, uma programação nomeada para um termostato.
cancelled A operação foi cancelada, geralmente pelo chamador
dataLoss Perda ou corrupção irrecuperável de dados.
deadlineExceeded O prazo expirou antes que a operação fosse concluída. Para operações que mudam o estado do sistema, esse erro pode ser retornado mesmo que a operação tenha sido concluída com sucesso. Por exemplo, uma resposta bem-sucedida de um servidor pode ter sido atrasada tempo suficiente para que o prazo expirasse.
failedPrecondition A operação foi rejeitada porque o estado do sistema não é o necessário para a execução dela. Por exemplo, você pode receber esta mensagem se tiver chamado stop em um forno que já está parado.
internal Erros internos. Isso significa que algumas invariantes esperadas pelo sistema subjacente foram corrompidas. Este código do erro é reservado para erros graves.
invalidArgument O cliente especificou um argumento inválido. Isso é diferente de ``failedPrecondition``. ``invalidArgument`` indica argumentos que são problemáticos, independentemente do estado do sistema, como um nome de arquivo incorreto.
notFound Você especificou uma entidade ou um recurso que não pode ser encontrado. Por exemplo, especificar um ID de faixa inexistente ao chamar play em um dispositivo de player de mídia.
outOfRange Um parâmetro excedeu o intervalo válido com base no estado atual do sistema. Essa mensagem ocorre quando o valor está dentro do intervalo de valores que a chamada de API pode aceitar, mas não faz sentido no contexto atual.
permissionDenied Você não tem permissão para executar a operação especificada. Esse código de erro não significa que a solicitação é válida.
resourceExhausted Alguns recursos foram esgotados. Por exemplo, isso pode ser gerado quando alguém chama dispense(item:amount:unit:presetName:) em um dispositivo de comedouro para animais de estimação e não há mais comida na unidade.
unauthenticated O autor da chamada não pode ser identificado ou a solicitação não tem credenciais de autenticação válidas.
unavailable O serviço está indisponível. Muito provavelmente, trata-se de uma condição temporária, que pode ser corrigida ao tentar novamente com uma retirada. Nem sempre é seguro repetir operações não idempotentes.
unimplemented A operação solicitada não foi implementada, aceita nem ativada neste serviço.
unknown Erro desconhecido. Em geral, unknown aparece quando ocorre uma condição de erro que não pode ser classificada usando nenhum dos outros códigos de erro. Por exemplo, esse erro pode ser retornado quando um valor de status recebido de uma API externa não tem informações suficientes sobre a causa raiz.