hoook
v0.1.0
Published
hoook is an event emitter with async and priority support.
Downloads
3
Readme
hoook
hoook is an event emitter with async and priority support.
Since hoook works a bit differently compared to "normal" event emitters
the methods are named fire
, hook
and unhook
instead of the known emit
, on
and off
.
Usage
var hoook = require('hoook');
// create a new object
var ee = hoook();
// hook with priority 50.
// higher priorities will run first.
ee.hook('foo', function(ev) {
// do something like sticking data
// to the event object..
ev.bar = 'middleware got called';
}, 50);
// by default the priority is 100.
// higher priority hooks will run
// before lower ones.
ee.hook('foo', function(ev) {
// do something...
});
// if the callback has two or more
// arguments it is considered an
// async hook.
ee.hook('foo', function(ev, next) {
setTimeout(function() {
// jump to the next middleware
// once finished.
next();
}, 1000);
});
// the middleware-chain can be aborted
ee.hook('foo', function(ev, next, stop) {
// jump directly to the final callback
stop();
});
// ...or you can abort it with an error
ee.hook('foo', function(ev, next, stop) {
stop(new Error('something went wrong'));
});
// emitting an event is as easy as
ee.fire('foo');
// pass in a callback which will be
// called once the callback chain has finished
ee.fire('foo', function(err, ev) {
if (err) {
// if the middleware-chain was aborted with an error.
// in this case ev will be undfined
}
});
// defining the ev object goes like this:
ee.fire('foo', { type: 'myEvent' }, function(err, ev) {
// by default ev is an empty object {}.
});
// remove all hooks listening to 'foo'
ee.unhook('foo');
// remove a specific hook
ee.unhook('foo', cb);
// remove all hooks
ee.unhook();
Installation
npm install hoook
License
MIT