Minimalist publish/subscribe.


sublish is a minimalist lightweight (663 Bytes minified and 336 Bytes gzipped) implementation of publish/subscribe.


npm install sublish
git clone
cd sublish
npm install
npm run test && npm run dist
component install pluma/sublish

Learn more about component.

bower install sublish

Learn more about bower.

Download the latest minified CommonJS release and add it to your project.

Learn more about CommonJS modules.

Download the latest minified AMD release and add it to your project.

Learn more about AMD modules.

Download the latest minified standalone release and add it to your project.

<script src="/your/js/path/sublish.globals.min.js"></script>

This makes the sublish module available in the global namespace.

Basic usage example

var myPubSub = require('sublish')();
var listener = function(message) {
  console.log('myPubSub says: "' + message + '"');
myPubSub.publish('something amazing');
// -> 'myPubSub says: "something amazing"' 
myPubSub.publish('talking to myself');
// -> nothing happens 

Extending by inheritance

var PubSub = require('sublish').PubSub;
var inherits = require('util').inherits;
function MyFancyPubSub() {;
inherits(MyFancyPubSub, PubSub);

Extending as a mixin

var PubSub = require('sublish').PubSub;
var extend = require('extend');
function MyFancyPubSub() {;
extend(MyFancyPubSub.prototype, PubSub.prototype);


Creates a new PubSub instance.

Adds the given function to the instance's subscribers.

Note: the function will be invoked with its this context set to the given ctx. If ctx is false-y, the PubSub instance will be used instead.

Removes the given function from the instance's subscribers.

Returns true if the subscriber exists, false otherwise.

Publishes the given arguments as a message. Every callback function in this object's list of subscribers will be called sequentially with the given messages as its arguments.


The MIT/Expat license. For more information, see or the accompanying LICENSE file.