Tratamento de erros no iOS

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

Um exemplo de como se pode 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 fornece os significados deHomeError Códigos que você poderá encontrar:

Mesa: HomeError códigos

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 essa 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 poderia ser lançado quando alguém chama dispense(item:amount:unit:presetName:) em um alimentador automático para animais de estimação e não há mais comida no aparelho.
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 está implementada, suportada ou habilitada 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 contém informações suficientes sobre a causa raiz.