Fehlerbehandlung unter iOS

Swift bietet integrierte Unterstützung für das Auslösen und Abfangen von behebaren Fehlern zur Laufzeit. Wenn beispielsweise ein Vorgang in Ihrem Code fehlschlägt oder ungültig ist, gibt die API einen HomeError-Fehler aus. Dadurch wird die Fehlerbehandlung vereinfacht und optimiert, da Sie sich nur auf behebliche Fehler konzentrieren können. Sie können dann Optionen anbieten, z. B. dem Nutzer erlauben, es noch einmal zu versuchen, oder eine Meldung wie „Struktur nicht gefunden“ anzeigen. Da Sie nicht jede mögliche Ausnahme explizit behandeln müssen, ist Ihr Code weniger unübersichtlich und konzentriert sich auf seinen primären Zweck.

Ein Beispiel dafür, wie ein behebbarer Fehler behandelt werden kann:

    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
    }

In der folgenden Tabelle finden Sie die Bedeutungen der HomeError-Codes, die Ihnen möglicherweise angezeigt werden:

Tabelle: HomeError codes

Code	Bedeutung
aborted	Der Vorgang wurde abgebrochen. Dies tritt in der Regel auf, wenn ein Parallelitätsproblem vorliegt, z. B. eine fehlgeschlagene Sequenzprüfung oder ein abgebrochener Vorgang.
alreadyExists	Die Ressource oder Entität, die Sie erstellen möchten, ist bereits vorhanden. Das kann beispielsweise ein benanntes Programm für einen Thermostat sein.
cancelled	Der Vorgang wurde abgebrochen, üblicherweise vom Aufrufer.
dataLoss	Dauerhafter Datenverlust oder Datenkorruption.
deadlineExceeded	Die Frist ist abgelaufen, bevor der Vorgang abgeschlossen werden konnte. Bei Vorgängen, die den Systemstatus verändern, kann dieser Fehler angezeigt werden, auch wenn der Vorgang erfolgreich abgeschlossen wurde. Zum Beispiel könnte eine erfolgreiche Antwort von einem Server so lange verzögert worden sein, dass die Frist abgelaufen ist.
failedPrecondition	Der Vorgang wurde abgelehnt, weil der Systemzustand nicht für die Ausführung des Vorgangs geeignet ist. Diese Meldung wird beispielsweise angezeigt, wenn Sie stop für einen Ofen aufgerufen haben, der bereits angehalten wurde.
internal	Interne Fehler. Das bedeutet, dass einige Invarianten, die vom zugrunde liegenden System erwartet werden, nicht erfüllt wurden. Dieser Fehlercode ist für schwerwiegende Fehler reserviert.
invalidArgument	Der Client hat ein ungültiges Argument angegeben. Dieser Wert unterscheidet sich von `failedPrecondition`. `invalidArgument` gibt Argumente an, die ungeachtet des Systemstatus problematisch sind (z. B. ein ungültiger Dateiname).
notFound	Sie haben eine Entität oder Ressource angegeben, die nicht gefunden werden kann. Wenn Sie beispielsweise beim Aufrufen von play auf einem Media-Player-Gerät eine nicht vorhandene Titel-ID angeben.
outOfRange	Ein Parameter hat den gültigen Bereich überschritten, basierend auf dem aktuellen Systemstatus. Diese Meldung wird angezeigt, wenn der Wert im Bereich der Werte liegt, die der API-Aufruf potenziell akzeptieren könnte, aber im aktuellen Kontext nicht sinnvoll ist.
permissionDenied	Sie sind nicht berechtigt, den angegebenen Vorgang auszuführen. Dieser Fehlercode sollte nicht so interpretiert werden, dass die Anfrage ansonsten gültig ist.
resourceExhausted	Eine Ressource ist aufgebraucht. Dies kann beispielsweise passieren, wenn dispense(item:amount:unit:presetName:) auf einem Gerät für die Fütterung von Haustieren aufgerufen wird und kein Futter mehr im Gerät ist.
unauthenticated	Der Aufrufer kann nicht identifiziert werden oder die Anfrage enthält keine gültigen Anmeldedaten für die Authentifizierung.
unavailable	Der Dienst ist nicht verfügbar. Dies ist höchstwahrscheinlich ein vorübergehender Zustand, der durch Wiederholen mit einem Backoff korrigiert werden kann. Es ist nicht immer sicher, nicht idempotente Vorgänge zu wiederholen.
unimplemented	Der angeforderte Vorgang ist in diesem Dienst nicht implementiert, wird nicht unterstützt oder ist nicht aktiviert.
unknown	Unbekannter Fehler. Im Allgemeinen wird unknown angezeigt, wenn ein Fehler auftritt, der nicht mit den anderen Fehlercodes klassifiziert werden kann. Dieser Fehler wird z. B. zurückgegeben, wenn ein von einer externen API empfangener Statuswert nicht genügend Informationen zur Ursache enthält.