messagy

Simple messaging in ~750 bytes of code

What is it?

messagyjs is yet another javascript messaging library and a very very tiny and minimalistic one.

Why another messaging library?

There are lots of robust messaging libraries supporting many patterns, but sometimes you just want something very simple for your small project or sample code or prototype so if things got serious you can easily replace it with something more robust and heavy-duty. And so messagy saves the day. messagy is a piece of simple code and it is here so you don't have to write your own or use a bit more complicated alternatives and focus on getting things started.

How can I use it?

There are only three methods in the library: on(), trigger() and off().

Example

    var messagy = new Messagy();
    messagy.on('case of event', function(){ alert('event happened!'); });
    messagy.trigger('case of event');

It's that simple.

You can also pass arguments to the listening callback:

    var messagy = new Messagy();
    messagy.on('case of event', function(value){ alert(value); });
    messagy.trigger('case of event', 'event happened!');

To remove your subscription:

    messagy.off('case of event', your_callback_here);
    //or to remove all subscribers to an event indiscriminately
    messagy.off('case of event');
    //or to remove all subscribers altogether
    messagy.off();

For convenience each method have a set of synonyms that you can call interchangeably:

• on: add or subscribe
• off: remove or unsubscribe
• trigger: broadcast or emit or propagate or publish

Calling these synonyms have no advantage over each other and they are present just so anyone can use the ones that is more comfortable with, as they are used in other libraries (jquery uses on/off/trigger in angular we have on/emit/broadcast and so on...)

Applications

messagy can thrive it simple applications:

• small applications
• prototyping
• where you don't want to use jQuery, postal, etc.
• where performance is of utmost importance
• where you just want no fuss simple messaging

Contribution

You are more than welcome to contribute to the project in forms of adding issues or making pull requests. Please consider that messagy is to be a very lightweight and fast library. Please add unit tests to your contributions, currently I use jasmine for in browser testing, but will add another framework for nodejs testing from command line, like mocha or node unit. Please report any issues or feature requests via github project issues.