Code & Transform

Throw-Error-Knoten

Den Workflow sofort stoppen und einen Fehler mit einer benutzerdefinierten Nachricht und optionalem Fehlercode auslösen.

Überblick

Der Throw-Error-Knoten stoppt die Workflow-Ausführung sofort und löst einen Fehler aus. Verwenden Sie ihn innerhalb eines Try / Catch-Bereichs, um den Fehlerpfad auszulösen, oder eigenständig, um den Flow mit einer aussagekräftigen Nachricht zu stoppen.

Dies ist nützlich, um Geschäftsregeln durchzusetzen, Vorbedingungen zu validieren oder Fehler zu signalisieren, die nachgelagerte Logik nicht ignorieren sollte.

Konfiguration

Feld Beschreibung Erforderlich
Error Message Eine beschreibende Nachricht, die erklärt, was schiefgelaufen ist Ja
Error Code Ein optionaler Code zur Kategorisierung des Fehlers (z. B. ERR_VALIDATION) Nein

Funktionsweise

Wenn der Throw-Error-Knoten ausgeführt wird:

  1. Der Workflow stoppt sofort an dieser Stelle.
  2. Wenn sich der Knoten innerhalb eines Try / Catch-Bereichs befindet, wird der Fehler abgefangen und der Flow zum ERROR-Ausgang des Try / Catch-Knotens geleitet.
  3. Wenn kein umgebender Try / Catch vorhanden ist, wird der gesamte Workflow mit einem Fehlerstatus beendet.

Die Fehlermeldung und der Fehlercode stehen als Variablen im Try / Catch-Fehlerpfad zur Verfügung, sodass Sie sie protokollieren, in einer API-Antwort zurückgeben oder in bedingter Logik verwenden können.

Beispiel: Eingabe vor der Verarbeitung validieren

Verwenden Sie Throw Error, um ungültige Daten frühzeitig abzulehnen:

Flow Start → Condition (is input valid?)
                ├── YES → Process Data → Output
                └── NO → Throw Error ("Missing required field: email")

Beispiel: Innerhalb eines Try / Catch

Kombinieren Sie es mit Try / Catch für kontrollierte Fehlerbehandlung:

Flow Start → [Try / Catch]
                 ├── Condition → Throw Error ("Unauthorized access", ERR_AUTH)
                 ├── SUCCESS → Continue
                 └── ERROR → Log Error → Send Alert

Beispiel: Durchsetzung von Geschäftsregeln

Den Workflow stoppen, wenn eine Geschäftsregel verletzt wird:

HTTP Request (get account) → Condition (balance < 0?)
                                 ├── NO → Continue
                                 └── YES → Throw Error ("Insufficient balance", ERR_BALANCE)

Best Practices

  • Schreiben Sie klare, spezifische Fehlermeldungen, die erklären, was schiefgelaufen ist und warum
  • Verwenden Sie Fehlercodes, um Fehler programmatisch zu kategorisieren (z. B. ERR_VALIDATION, ERR_AUTH, ERR_NOT_FOUND)
  • Umschließen Sie Throw Error mit einem Try / Catch, wenn Sie den Fehler elegant behandeln möchten, anstatt den gesamten Workflow zu stoppen
  • Verwenden Sie Throw Error nach Condition-Knoten, um Vorbedingungen frühzeitig im Flow durchzusetzen

Wir aktualisieren diese Seiten laufend. Ist etwas nicht mehr aktuell? Sagen Sie es uns

AI AssistantPowered by Ubex
Beta
Ask me anything about Ubex workflows, nodes, or the API.