Try / Catch Blocks

Try/Catch Blocks are helpful when you need to change the default handling of errors, perhaps to run an error handler, or to change the status shown to viewers of the execution.

By default, when an errors occur during the execution of a plan:

1. the execution status is changed to failing
2. the execution halts

With a Try/Catch block, if an error occurs in the main ("try") body, then the error handler ("catch") statements are run instead.

try
{
throw Something failed;
}
catch
{
Log-Information Something went wrong, but continuing;
}
Log-Information Script continued;

How Error Handling Works in OtterScript

By default:

• Any error inside try stops execution and marks the job as failing.
• With a try/catch statement:
  • The error is caught.
  • Execution continues with catch instead of halting.

After catch:
* Execution resumes with the next statement after the try/catch statement.

Changing Execution Status in Catch

Sometimes you don't want an error to count as a total failure — maybe just a warning.

You can use the warn statement inside catch:

try
{
    throw Something failed;
}
catch
{
    warn;
}
Log-Information Script continued;

Example Output:

DEBUG: 2025-05-22 03:30:13Z - Beginning execution run...
ERROR: 2025-05-22 03:30:13Z - Something failed
INFO : 2025-05-22 03:30:13Z - Script continued
WARN : 2025-05-22 03:30:13Z - Execution run succeeded with warnings.

In this case:

• The overall execution status becomes "Warn" instead of "Fail".
• Execution proceeds normally after the block.

You can also use force normal to suppresses the error, treating the execution as fully successful.

try
{
    throw an error occurred;
}
catch
{
    force normal;
}
Log-Information Script continued;

Example Output:

DEBUG: 2025-05-22 03:34:13Z - Beginning execution run...
ERROR: 2025-05-22 03:34:13Z - an error occurred
INFO : 2025-05-22 03:34:13Z - Script continued
INFO : 2025-05-22 03:34:13Z - Execution run succeeded.

Nested Try/Catch Statements

OtterScript lets you nest try/catch statements if needed:

try
{
    try
    {
        throw Inner error occurred;
    }
    catch
    {
        Log-Information Inner error caught;
        throw Outer error occurred;
    }
    Log-Information After inner try/catch;
}
catch
{
    Log-Information Outer error caught;
}
Log-Information Script continued;

Example Output:

DEBUG: 2025-05-22 13:07:00Z - Beginning execution run...
ERROR: 2025-05-22 13:07:00Z - Inner error occurred
INFO : 2025-05-22 13:07:00Z - Inner error caught
ERROR: 2025-05-22 13:07:00Z - Outer error occurred
INFO : 2025-05-22 13:07:00Z - Outer error caught
INFO : 2025-05-22 13:07:00Z - Script continued

Retry on Error

You can configure certain statements or operations to automatically retry on failure. This is especially useful for transient issues like temporary network glitches:

retry 3
{
    Log-Information script running;
}