global-error-handling
Implement proper error handling patterns for n8n nodes using NodeApiError and NodeOperationError classes. Use this skill when writing try-catch blocks in execute methods, handling HTTP errors, validating parameters, parsing API error responses, implementing continueOnFail logic, writing actionable error messages, or handling errors in trigger nodes. Apply when working with external API calls, authentication errors, rate limiting, or any error scenarios in n8n node development.
When & Why to Use This Skill
This Claude skill provides expert guidance on implementing robust error handling patterns specifically for n8n node development. It ensures developers correctly utilize NodeApiError and NodeOperationError classes to manage HTTP failures, validate input parameters, and build resilient automation workflows with actionable, user-friendly error messaging.
Use Cases
- case 1: Managing complex HTTP status codes (such as 429 rate limits or 401 authentication errors) when building custom integrations for external APIs in n8n.
- case 2: Implementing 'continueOnFail' logic within execute methods to ensure that batch processing workflows remain stable even when individual items encounter errors.
- case 3: Validating required node parameters and input formats to prevent runtime crashes and provide clear feedback to the end-user.
- case 4: Enhancing security by redacting sensitive information from error outputs and logs while maintaining enough context for debugging.
- case 5: Standardizing error responses in trigger nodes to help users troubleshoot setup issues during the initial workflow configuration.
| name | Global Error Handling |
|---|---|
| description | Implement proper error handling patterns for n8n nodes using NodeApiError and NodeOperationError classes. Use this skill when writing try-catch blocks in execute methods, handling HTTP errors, validating parameters, parsing API error responses, implementing continueOnFail logic, writing actionable error messages, or handling errors in trigger nodes. Apply when working with external API calls, authentication errors, rate limiting, or any error scenarios in n8n node development. |
When to use this skill:
- When writing try-catch blocks in n8n node execute methods
- When handling HTTP request errors (401, 404, 429, etc.)
- When choosing between NodeApiError and NodeOperationError
- When validating required parameters and input formats
- When parsing error responses from external APIs
- When implementing continueOnFail() logic for batch processing
- When writing actionable, user-friendly error messages
- When redacting sensitive information from error output
- When handling errors in trigger node setup
- When adding error descriptions that help users fix issues
- When dealing with authentication, rate limiting, or external service failures
Global Error Handling
This Skill provides Claude Code with specific guidance on how to adhere to coding standards as they relate to how it should handle global error handling.
Instructions
For details, refer to the information provided in this file: global error handling