events-observer

Observer pattern

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
events-observer
001.0.16 years ago6 years agoMinified + gzip package size for events-observer in KB

Readme

EventsObserver.js
!Latest NPM releasenpm-badgenpm-badge-url !Licenselicense-badgelicense-badge-url

EventsObserver javascript template ###

EventsObserver template provides possibility to create custom events and trigger them. You can organize events to events tree. Trigger, add and delete events handlers. Return promise in event handler to call async handlers in the order.

Install ###

Install using npm
npm i -s events-observer
and then import constructor from events-observer npm module
or
download EventsObserver.min.js file from this repository root and include it to html (ES5 usage, this is last built version):
<script src="EventsObserver.min.js"></script>

Usage ###

If you have imported es6+ EventsObserver module
import EventsObserver from 'events-observer';
or loaded it using script tag, you should create instance of EventsObserver constructor.
var observer = new EventsObserver();

Also, you can pass separator property to define how events patch should be parsed. By default events path separator is . and your events path should looks like:
var observer = new EventsObserver();
observer.on('event_1.sub-event_1.sub-event_1_1', ...);
but if you change separator setting, for example to "/", it will looks like:
var observer = new EventsObserver('/');
observer.on('event_1/sub-event_1/sub-event_1_1', ...);

You can create events tree and trigger event handlers in order that handlers were added. Also it works with async handlers. If event handler returns promise next handler will be executed only if previous handler promise is resolved.

What is EVENTS TREE ? ###