simple-event

Simple event implementation: dispatch payload to one or many listeners

Motivation

This is an essential building block for any reactive-style library or application.

Features

• Subscribe and unsubscribe listeners
• Optionally send any payload when emitting event
• Emit promises: the event will be fired off automatically when the promise resolves

Installation

npm install simple-event

Usage

 
var simpleEvent = require('simple-event');
 
// Create event
var myEvent = simpleEvent();
 
// Subscribe a function
myEvent.subscribe(handleSimpleEvent);
myEvent.subscribe(function (data1, data2, data3) {
    .......
});
 
// Subscribe function in some context
myEvent.subscribe(function (message) {
    console.log(this.controllerName, message);
}, myController);
 
// Emit event
myEvent.emit();
 
// Emit some message
myEvent.emit(message, someExtraData);
 
// Emit promise: the event will be fired when the promise is resolved
var myData = $http.get('http://blah.com/data');
myEvent.emit(myData);
 
// Unsubscribe
myEvent.unsubscribe(handleSimpleEvent);