callback-stack v1.2.0

callback-stack for NodeJS

callback-stack is NodeJS module for creating groups of callbacks and reacting on all their execution

##Installation Use NPM to install this module:

$ npm install callback-stack

##Example

const CS = require('callback-stack'); //Explanation is not needed, yeah?

var cstack = new CS(); //Create new empty stack
cstack = new CS(1); //Or maybe you want to tell constructor how much callbacks you need?

//Add 'on all callbacks executed' callback
cstack.then(() => { 
	console.log('All callbacks executed successfully');
});

//And error catching callback (catching error that generated callback got & from your 'on all callbacks executed' callbacks)
cstack.catch((err) => {
	console.log('Error: ' + err.message);
});

//Set how frequently (im milliseconds) checks for complecity will be performed
cstack.checkEvery(666);
	
//Create new callback and execute it (newCallback returns created callback)
//After that, .then callback(s) will be executed, because there's only one added to stack callback
cstack.newCallback()('useless text');

//Reset executions count, so you can reuse object again
cstack.reset(); 

//You do not need index to get function, because the secret of module is - there's only one callback function
//Get and execute function with error passed
//This will call .catch callback(s) with error passed to them
cstack.getCallback()(new Error('Test cool error catching'));
cstack.reset();

//You can use 'newCallbacks' for increasing count of callbacks more than by 1
cstack.newCallbacks(3).forEach((cb) => {
	cb();
});

cstack.reset();
//Our object also have it's own forEach with index so you can use it like for-each loop
cstack.forEach((cb, i) => {
	console.log('Executing callback #' + i);
	cb();
});

cstack.reset();

//And you ofcourse can just get whole stack as array
cstack.getCallbacks().forEach((cb) => {
	console.log('Executing callback');
	cb();
});

//And ofcourse you can do things like this
//Most of functions return stack obj so it allows you to build structures like this
var cstack2 = new CS(1).checkEvery(10000).then(() => {
	console.log('Success');
}).catch((err) => {
	console.log('Error: ' + err.message);
}).forEach((cb, i) => {
	fs.readFile();
	cb();
});