Promises/A+ micro library to help with asynchronous work flow. The deferred methods match jQuery's when possible for convenience and familiarity, but under the hood it is a Promises/A+ spec!
Promises (deferreds/futures/etc.) are a way to create a tangible connection between now and an eventual outcome. Promises are a good pattern for asynchronous I/O, such as API interaction, AJAX operations, etc., by providing optional success & failure handling.
A then() will return a new Promise which is in a hierarchal relationship. When a "parent" is reconciled, it's "children" inherit the outcome.
API
always
Method
Registers a function to execute after Promise is reconciled
param {Function} arg Function to executereturn {Object} Deferred
Example
var deferred = assure();deferred.always(function() { console.log("This is always going to run");});
done
Method
Registers a function to execute after Promise is resolved
param {Function} arg Function to executereturn {Object} Deferred
Example
var deferred = assure();deferred.done(function() { console.log("This is going to run if Promise is resolved");});
fail
Method
Registers a function to execute after Promise is rejected
param {Function} arg Function to executereturn {Object} Deferred
Example
var deferred = assure();deferred.fail(function() { console.log("This is going to run if Promise is rejected");});
isRejected
Method
Determines if Deferred is rejected
return {Boolean} `true` if rejected
Example
var deferred = assure();deferred.isRejected(); // false, it's brand new!
isResolved
Method
Determines if Deferred is resolved
return {Boolean} `true` if resolved
Example
var deferred = assure();deferred.isResolved(); // false, it's brand new!