README
Synopsis
This is yet another event emitter implementation for node.js. It is nearly fully compatible with the node EventEmitter API (see the differences section). The main purpose for node-ev is to provide very fast event emission when dealing with a relatively low number of listeners. Run the provided benchmarks to see if this is for you.
Differences with node's EventEmitter
- New methods
.off(event[, listener])
: alias to removeListener()
.emit_myevent()
: alias for emit('myevent')
- Listeners are triggered without any context whereas EventEmitter applies the emitter's
API
var EV = require('ev')
var ev = new EV({ match: 2 })
function test (a) {
console.log('received', a)
}
ev.on('match', test)
ev.emit('match', 'standard emit')
ev.emit_match('shortcut emit!')
Methods
on(event, listener)
: add a listener for [event]once(event, listener)
: add a listener for [event] and remove it once triggeredoff(event, listener)
: remove the listener for [event]off(event)
: remove all listeners for [event]removeAllListeners(event)
: remove all listeners for [event]removeAllListeners()
: remove all listeners for all eventsemit(event[, arguments])
: emit [event] with a list of argumentssetMaxListeners(max)
: set the maximum number of listeners after which a warning is issued, but the listeners are still addedlisteners([event])
: get the list of listeners for [event] or all listeners for all events