Tratamento de erros no iOS

O Swift oferece suporte integrado para geração e captura de erros recuperáveis em tempo de execução. Por exemplo, se uma operação no seu 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 nos erros recuperáveis. Em seguida, ofereça opções, como permitir que o usuário tente de novo ou mostrar uma mensagem como "Estrutura não encontrada". Como você não precisa processar explicitamente todas as exceções possíveis, o código fica menos confuso e, consequentemente, mais focado na finalidade 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 os significados dos códigos HomeError que você pode encontrar:

Tabela: HomeError codes

Código	Significado
aborted	A operação foi cancelada. Isso geralmente aparece quando há um problema de simultaneidade, como uma falha na verificação de sequência ou um cancelamento de 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 problemáticos, independentemente do estado do sistema. Por exemplo, um nome de arquivo incorreto.
notFound	Você especificou uma entidade ou um recurso que não foi 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 deve ser interpretado como se a solicitação fosse válida.
resourceExhausted	Algum recurso foi esgotado. Por exemplo, isso pode acontecer quando alguém chama dispense(item:amount:unit:presetName:) em um dispositivo de alimentação de animais de estimação e não há mais comida na unidade.
unauthenticated	Não foi possível identificar o autor da chamada 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, permitida ou 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 que não tem informações suficientes sobre a causa raiz.