Skip to main content
Version: Latest (4.49.0-beta)

Error handling

This section describes the behavior of the error output as seen on most components.

As the default behavior, all errors occurring within components are automatically logged to the console and simultaneously stored in the system's database.

Error output

The error output is a JSON object with the following structure:

{
"error": {
// Information about the error
},
"value": {
// Usually the message that was passed to the component, in some scenarios a more detailed value is passed for debugging purposes. For example when a JSON parse error occurs, in the Template Engine component.
// In case of a custom code (in the code component or hooks), this is the data that was passed to the error() function
}
}

Tailored error handling

To establish a tailored error-handling approach, you can establish a connection between the error output and another component for more advanced processing. This capability can be particularly useful for implementing a retry mechanism, among other possibilities. Once connections have been established with the error output, any errors encountered will no longer be displayed on the console.

If you still prefer to have error messages displayed on the console, you have the option to configure this by setting the XILL4_SHOW_WARNING_ON_ERROR_CONNECTED environment variable to true. For additional details, please refer to the Environment Variables section for more comprehensive information.