PseudoPromise
A JavaScript pseudo Promise library for managing multiple async functions w/o using setTimeout/setInterval.
PseudoPromise is a JavaScript class to provide a basic framework to manage multiple asynchronous function calls. PseudoPromise does NOT provide a full Promise/A+ implementation & has no intention to ever do so! This class was created to solve the "multiple asynchronous function management" problem in a very simple straight forward manor without using the setTimeout() or setInterval() functions.
Why no setTimeout/setInterval? Well there's a few reasons:
- Some places where JavaScript is available - sadly setInterval and/or setTimeout may not be
- Continual polling is avoided (potential positive impact on performance)
Current Features
- Queue up multiple function calls
- Ability to "complete" after (1, 2,... N) successful function completions
- Ability to store arbitrary data in the instance
- Bails out on first error
API:
// Initialize...
var x = new PseudoPromise();
// Methods:
// Add a function
PseudoPromiseInstance.addMethod('functionID', functionReference);
// Indicate when a asynchronous function has completed (success or error)
PseudoPromiseInstance.markComplete(functionID, wasSuccessful);
// Start the batch of functions...
PseudoPromiseInstance.start(minCompletedCount, successHandler, errorHandler);
Usage:
// Initialize...
var swear = new PseudoPromise();
// Add functions...
swear.addMethod('foo', doFoo);
swear.addMethod('bar', doBar);
swear.addMethod('baz', doBaz);
//start the batch of functions...
swear.start(1, successHandler, errorHandler);
//setting the minCompletedCount to 1 will execute the successHandler
//when the first (e.g. any) function completes successfully