Gestion des erreurs sur iOS

Swift fournit une prise en charge intégrée pour générer et intercepter des erreurs récupérables au moment de l'exécution. Par exemple, si une opération de votre code échoue ou n'est pas valide, l'API génère une erreur HomeError. Cela simplifie et accélère la gestion des erreurs en vous permettant de vous concentrer uniquement sur les erreurs récupérables. Vous pouvez ensuite fournir des options, par exemple permettre à l'utilisateur de réessayer ou afficher un message tel que "Structure introuvable". Étant donné que vous n'avez pas à gérer explicitement toutes les exceptions possibles, votre code est moins encombré et, par conséquent, reste plus axé sur son objectif principal.

Exemple de gestion d'un échec récupérable:

    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
    }

Le tableau suivant indique la signification des codes HomeError que vous pouvez rencontrer:

Tableau: codes HomeError
Code Signification
aborted L'opération a été annulée. Ce message s'affiche généralement en cas de problème de simultanéité, tel qu'un échec de vérification de séquence ou un abandon de transaction.
alreadyExists La ressource ou l'entité que vous essayez de créer existe déjà. Il peut s'agir, par exemple, d'une programmation nommée pour un thermostat.
cancelled L'opération a été annulée, généralement par l'appelant.
dataLoss Perte ou corruption de données irrécupérable.
deadlineExceeded Le délai a expiré avant que l'opération puisse se terminer. Pour les opérations qui modifient l'état du système, cette erreur peut être affichée même si l'opération s'est terminée avec succès. Par exemple, une réponse réussie d'un serveur a été retardée suffisamment longtemps pour que le délai expire.
failedPrecondition L'opération a été rejetée car le système n'est pas dans un état requis pour exécuter l'opération. Par exemple, ce message peut s'afficher si vous avez appelé stop sur un four déjà arrêté.
internal Erreurs internes. Cela signifie que certains invariants attendus par le système sous-jacent n'ont pas été respectés. Ce code d'erreur est réservé aux erreurs graves.
invalidArgument Le client a spécifié un argument incorrect. Notez que cette valeur diffère de "failedPrecondition". "invalidArgument" indique les arguments problématiques quel que soit l'état du système (par exemple, un nom de fichier incorrect).
notFound Vous avez spécifié une entité ou une ressource introuvable. Par exemple, spécifier un ID de piste inexistant lors de l'appel de play sur un appareil de lecteur multimédia.
outOfRange Un paramètre a dépassé la plage valide, en fonction de l'état actuel du système. Ce message s'affiche lorsque la valeur se trouve dans la plage de valeurs que l'appel d'API pourrait potentiellement accepter, mais qu'elle n'a pas de sens dans le contexte actuel.
permissionDenied Vous n'êtes pas autorisé à exécuter l'opération spécifiée. Ce code d'erreur ne doit pas être interprété comme signifiant que la requête est valide.
resourceExhausted Une ressource est épuisée. Par exemple, cette exception peut être générée lorsqu'on appelle dispense(item:amount:unit:presetName:) sur un distributeur de nourriture pour animaux de compagnie et qu'il n'y a plus de nourriture dans l'appareil.
unauthenticated L'appelant ne peut pas être identifié ou la requête ne dispose pas d'identifiants d'authentification valides.
unavailable Le service est indisponible. Il s'agit probablement d'une condition temporaire qui peut être corrigée en réessayant après avoir laissé passer un intervalle entre les tentatives. Notez qu'il n'est pas toujours sûr de relancer des opérations non idempotentes.
unimplemented L'opération demandée n'est pas implémentée, prise en charge ou activée dans ce service.
unknown Erreur inconnue. En règle générale, unknown s'affiche lorsqu'une condition d'erreur se produit et ne peut être classée à l'aide d'aucun des autres codes d'erreur. Par exemple, cette erreur peut s'afficher lorsqu'une valeur d'état reçue d'une API externe ne dispose pas d'informations suffisantes sur la cause du problème.