reemitter.js

JavaScript event-emitter based on necolas's version with some innovation.

Installation

Install with Bower:

bower install --save reemitter.js

The component can be used as a Node.js module, an AMD module, or a global.

API

Emitter(obj)

The Emitter function can be used as a Constructor or as a mixin.

As an Emitter instance:

var Emitter = require('emitter');
var foo = new Emitter;
foo.trigger('foo');

As a mixin:

var Emitter = require('emitter');
var foo = {};
Emitter(foo);

foo.trigger('bar');

As a prototype mixin:

var Emitter = require('emitter');
var Foo = function () {};
Emitter(Foo.prototype);

Emitter#on(event, callback)

Register an event handler callback. Protects against duplicate handlers being registered.

var handler = function () {
    console.log('The function `handler` has been registered for the event `foo`.');
};

foo.on('foo', handler);

Emitter#once(event, callback)

Register a one-off event handler callback, removed immediately after it is invoked the first time.

var handler = function () {
    console.log('The function `handler` has been registered as a one-off callback for the event `foo`.');
};

foo.once('foo', handler);

Emitter#off([event], [callback])

Remove the event handler callback. If no callback is specified, it will remove all callbacks for the event. If no event is specified, the entire event registry will be deleted.

var handler = function () {
    console.log('Registered for the event `foo`.');
};

foo.off('foo', handler);
foo.off('foo');
foo.off();

Emitter#emit(event, [...])

Trigger an event with optional arguments. Alias: trigger.

var data = { name: 'nicolas' };
foo.trigger('foo', data);

Emitter#getListeners(event)

Return an array of callbacks registered for the event, or an empty array. Initializes the registry if necessary.

foo.getListeners('foo');

Emitter#hasListeners(event)

Check if any callbacks are registered for the event.

foo.hasListeners('foo');

Emittter#reemit(event, [...])

Trigger the event and also make sure for callbacks get registered later will be called directly with the arguments

var data = { name: 'nicolas' };
foo.trigger('foo', data);

Testing

Install and run the test suite:

make

Re-run the test suite:

make test

Browser support

• Google Chrome (latest)
• Opera (latest)
• Firefox 4+
• Safari 5+
• Internet Explorer 8+