Debugging

To debug hyperpotamus scripts, use the hdb executable (short for "Hyperpotamus DeBugger") and run your script using the same command-line arguments that you normally would. This will launch the node.js debugger and allow you to step through the processing to debug logical errors.

There are a LOT of steps to trace through an entire script, so two of the most helpful techniques for getting to the right spot are:

1. Add a debugger: true property to your action elements. This will cause the debugger to hit a breakpoint before a plugin is executed for processing the action.

2. Adding debugger; statements within the javascript code. Either within your custom plugins or in the hyperpotamus source-code itself.

Once you have launched the node.js debugger, you can use the standard step/next/out/in options.