PrettyMonitor
PrettyMonitor is a small debug utility that catches escaped when.js rejections in node.js apps and renders them in a readable format.
Screenshot
This is similar to when.js's default monitoring tool: when/monitor/console.
Here is a screenshot of the original tool (as of when-3.1):
PrettyMonitor does the same thing with some formatting:
when-3.x
)
Usage (in Install with npm:
npm install pretty-monitor
And in your javascript:
// require the dependencies first:wn = ;PrettyMonitor = ;PromiseMonitor = ; // then, instantiate the monitor:promiseMonitor = ; // ... and start it:promiseMonitor; // to see a sample rejection:;
when-3.1
Note on The monitoring api on when-3.1
looks a tiny bit different:
// require the dependencies first:wn = ;PrettyMonitor = ;PromiseMonitor = ; // this is the different part:consolepromiseMonitor = ; // to see a sample rejection:;
when-2.x
)
Usage (in Install with npm:
npm install pretty-monitor@0.1.7
And then require it somewhere in your code:
start; // to see a sample rejection:var wn = ;start; ;
Customization
PrettyMonitor uses PrettyError to render the rejections. PrettyError is very customizable. You can set themes, customize layout and colors, and simplify the stack trace. There are a bunch of examples at PrettyError's docs, so, make sure to check them out.
To access the PrettyError instance when using PrettyMonitor:
prettyError = prettyMonitor; // if you're using pretty-monitor@0.1.x:prettyError = prettyMonitorstart;
State of The Project
This is a work in progress. I'll try to fix bugs and keep it up-to-date with when.js. Feel free to open an issue if something isn't working, and of course, Pull Requests are more than welcome :)
License
MIT