Skip to main content

Error Catcher

Catches and handles errors from other nodes in the workflow.

Overview​

The Error Catcher node collects error items from nodes whose error outputs are not connected. Use it to:

  • Prevent workflow failures from unhandled errors
  • Centralize error handling
  • Log or process errors in one place

How It Works​

  1. Nodes that encounter errors create error items
  2. Error items go to the node's error output
  3. If the error output is not connected, the error is "uncaught"
  4. Error Catcher collects all uncaught errors from upstream nodes

Parameters​

The Error Catcher has no parameters. It automatically collects uncaught errors.

Output​

Error items with details about what failed:

{
  "error": "Failed to process item: Invalid data format",
  "sourceNode": "Edit Item",
  "sourceItem": { /* original item data */ }
}

Examples​

Centralized Error Logging​

Collect all errors and save to a log:

[Node A] ─────────────────────→ [Output]
[Node B] ─────────────────────→ [Output]

[Error Catcher] → [Insert Rows: ErrorLog]

Both Node A and Node B can fail; Error Catcher collects both.

Error Notification​

Send alerts for errors:

[Processing Pipeline] → [Output]

[Error Catcher] → [Edit Item: format] → [Send Gmail: alert]

Error Recovery​

Attempt to recover from errors:

[Primary Process] → [Success Output]

[Error Catcher] → [Fallback Process] → [Output]

Multiple Error Catchers​

You can have multiple Error Catchers in different positions to handle errors from specific sections:

Section A:
[Node A1] → [Node A2] → [Error Catcher A] → [Handle A Errors]

Section B:
[Node B1] → [Node B2] → [Error Catcher B] → [Handle B Errors]

Error Catcher vs Connected Error Outputs​

You can handle errors two ways:

1. Connect Error Output Directly​

Connect a node's error output to handle that specific node's errors:

[Node] ── main ──→ [Next Node]
       └─ errors → [Handle This Node's Errors]

2. Use Error Catcher​

Let Error Catcher collect all unhandled errors:

[Node A] ─────→ [Next]    (errors unconnected)
[Node B] ─────→ [Next]    (errors unconnected)

[Error Catcher] → [Handle All Errors]

Tips​

  • Place Error Catcher after the nodes whose errors you want to catch
  • Errors from nodes with connected error outputs are NOT caught
  • Error Catcher runs after other nodes complete
  • Use Edit Item after Error Catcher to format error details
  • Consider sending error notifications for production workflows
  • Error Catcher itself can fail (handle carefully)