TOC
Co-events
API
Listeners can be anything that co supports viz. promises, thunks, generators, arrays or objects..
var events, fs, read;
events = new CoEvents;
fs = require('fs');
read = function(filename) {
return function(cb) {
return fs.readFile(filename, cb);
};
};
events.on('readFile', function*(filename) {
return callback(null, yield read(filename));
});
return events.emit('readFile', 'LICENSE');
Good old EventEmitter style functions.
var events, fs;
events = new CoEvents;
fs = require('fs');
events.on('readFile', function(filename) {
return callback(null, fs.readFileSync(filename));
});
return events.emit('readFile', 'LICENSE');
Listener called when event emitted.
var events;
events = new CoEvents;
events.on('event', function*() {
return callback(null);
});
return events.emit('event');
Arguments sent by emit are applied to listener.
var events;
events = new CoEvents;
events.on('wait', function*(time) {
yield wait(time);
return callback(null);
});
return events.emit('wait', 500);
RemoveListener can remove attached listeners.
var events, fn;
events = new CoEvents;
fn = function*() {
return 'Hello';
};
events.on('hello', fn);
events.removeListener('hello', fn);
assert.equal(false, events.emit('hello'));
return callback(null);
Events registered using .once are removed once they are fired.
var events;
events = new CoEvents;
events.once('hello', function*() {
return 'Hello';
});
events.emit('hello');
assert.equal(false, events.emit('hello'));
return callback(null);
Aliases
.off is an alias of .removeListener and .trigger is an alias of .emit.
var events, fn;
events = new CoEvents;
fn = function*() {
return 'Hello';
};
events.on('hello', fn);
events.trigger('hello');
events.off('hello', fn);
assert.equal(false, events.trigger('hello'));
return callback(null);
