event-custodian
Control handlers for an event set on an EventEmitter
Usage
TL;DR
const Custodian = require('event-custodian');
new Custodian(emitter, 'event').mount().on('error', (error) => logger.error(error));
new Custodian(process, 'unhandledRejection').mount().on('error', (error) => console.error(error));
Motivation
By overriding native behaviour we can verify existing event handlers run in a safe environment, within a try/catch block. This way we can avoid unexpected results, such as the process exiting unexpectedly within an event handler. We can later decide how we want to handle these errors by placing a general onerror handler on the custodian.
Detailed example using process and "unhandledRejection"
const custodian = new Custodian(process, 'unhandledRejection');
custodian.mount();
custodian.on('error', (error) => logger.error(error));
process.on('unhandledRejection', console.error)
.prependListener('unhandledRejection', (error) => { ... })
.off('unhandledRejection', console.error)
.removeAllListeners('unhandledRejection');
custodian.unmount();
Important note about 'unhandledRejection'
If you use this application to manage unhandledRejection
, you must set an on('error')
handler. Otherwise the custodian will simply print the errors onto console.error
.