0.0.7 • Published 12 years ago
ev v0.0.7
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 toremoveListener()
.emit_myevent()
: alias foremit('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') // received standard emit
ev.emit_match('shortcut emit!') // received shortcut emit!
Methods
on(event, listener)
: add a listener for eventonce(event, listener)
: add a listener for event and remove it once triggeredoff(event, listener)
: remove the listener for eventoff(event)
: remove all listeners for eventremoveAllListeners(event)
: remove all listeners for eventremoveAllListeners()
: 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