subscribers

subscribers

A tiny library to manage lists of subscribers. Think of it as a “single event”. Use it when an event emitter is too much.

Focus has been minimal API surface and fast notification.

Installation

npm install subscribers

API

• Import the library:

var subscribers = require('subscribers');

• create a list of subscribers

var list = subscribers();
// or in ES6:
const {subscribe, notify} = subscribers();

• register subscribers:

list.subscribe(function() { /* ... */ });
subscribe(() => {}); // ES6

• notify subscribers:

list.notify({some: 'value'} /*, ... */);
notify({any: 'other value'} /*, ... */); // does not depend on `this` binding

• unsubscribe:

var unsubscribe = subscribe(function() {});
unsubscribe();

• Use it in other objects:

class UnicornNews {
  constructor() {
    const {notify, subscribe} = subscribers();
    this.subscribe = subscribe; // does not depend on `this` binding
  }
}