try

Learn how to handle errors in template execution.

This action wraps actions with error handling, similar to a try/catch/finally block.

If the action fails, the else branch runs as a fallback. The finally branch always runs regardless of the outcome. When there is no else branch, use help to enrich the error message with suggestions and links.

Example

The following template attempts an action that always fails and handles the error gracefully:

template.json5

{  "$schema": "https://schema.croct.com/json/v1/template.json",  "title": "Error handling",  "description": "Demonstrates error handling with try.",  "actions": [    {      "name": "try",      "action": {        "name": "fail",        "message": "Something went wrong."      },      "else": {        "name": "print",        "semantics": "warning",        "message": "The action failed, but we recovered."      },      "finally": {        "name": "print",        "message": "Done."      }    }  ]}

To apply this template, run:

npx croct@latest use template.json5
Run

Custom help

When there is no else branch, use help to provide context for the error:

template.json5

{  "$schema": "https://schema.croct.com/json/v1/template.json",  "title": "Dependency checker",  "description": "Checks for required dependencies.",  "actions": [    {      "name": "try",      "action": {        "name": "check-dependency",        "dependencies": [          {"name": "next"}        ]      },      "help": {        "message": "This template requires a Next.js project.",        "suggestions": [          "Create a new Next.js project and try again."        ],        "links": [          {            "label": "Next.js docs",            "url": "https://nextjs.org/docs"          }        ]      }    }  ]}