@valerii-zinchenko/observer

Observer

Simple observer to work with events. It can be used as a stand-alone observer or can be mixed in in some other object/function/class to directly reuse the functionality of an observer there.

All attached event handlers are stored in FIFO order. They are stored as is, i.e. if binding to some context is required then it should be done manually.

Requirements

It is written on vanilla JavaScript :)

It does not require any additional libraries.

Installation

$ npm install valerii-zinchenko/observer --save
$ grunt build

Available library files:

• dest/observer.js - not minified library
• dest/observer.min.js - minified library

The destination library files are surrounded with the universal module definition. So it can be loaded

• as a module for NodeJS
• as an AMD module
• or will be stored into the global variable under the name Observer

Usage

Simple event with property

// start listen 'hi' event by constructing a new instance
var observer = new Observer('hi', function(name) {
	console.log('hi ' + name);
});

// start listen 'hi' event with a new handler function
observer.listen('hi', function(name) {
	console.log('hi ' + name + ' again');
});


observer.trigger('hi', 'world');
// The followwing lines will be logged in the console.
// 'hi world'
// 'hi world again'

Example of encapsulating of Observer functionality into a class, by using a class-wrapper.

// Define classes
// --------------------
// Human class, that can call a cat and receive an answer
var Human = Class(function() {
	// listen an "answer" event, i.e. an answer from someone
	this.listen('answer', this.onAnswer);
}, {
	Encapsulate: Observer,

	// call a cat
	callCat: function(cat) {
		cat.trigger('call', this);
	},

	// handle an answer from a cat
	onAnswer: function(answer) {
		console.log(answer);
	}
});

// Cat class, that listens any calls and answers to the caller
var Cat = Class(function() {
	// listen "call" event, i.e. someone will call a cat
	this.listen('call', this.onCall);
}, {
	Encapsulate: Observer,
	
	// handle a "call" event
	onCall: function(initiator) {
		// answer to an initiator
		initiator.trigger('answer', 'Meow! :P');
	}
});
// --------------------


// Create instances
// --------------------
var human = new Human();
var cat = new Cat();
// --------------------


// some human calls some cat
human.callCat(cat);
// The following line will be logged into the console
// 'Meow! :P'

Links

• wiki
• API
• Code coverage
• Run unit tests