fist.util.promise
JS Promises/A+ implementation
Instance API
Static API
Instance API###
new Promise()
####
Constructor, creates a new promise object
promise = ;
promise.then([onFulfilled], [onRejected])
####
See https://github.com/promises-aplus/promises-spec#the-then-method
promise2 = promise1;
promise.resolve([value])
####
Resolves the promise according to promise resolution procedure
promise;
promise.fulfill([result])
####
Fulfills promise with result
promise;
promise.reject([reason])
####
Rejects promise with reason
promise;
promise.always([onResolved])
####
Calls reason
when the promise will be resolved
promise;
promise.done([onFulfilled], [onRejected])
####
Terminates promise chaining, if the last promise was rejected, an exception will be thrown
promise;
promise.fail([onRejected])
####
Simple shortcut for promise.then(undefined, onRejected);
promise;
promise.isFulfilled()
####
Returns true
if the promise is in fulfilled state
promise;promise; // -> true
promise.isPending()
####
Returns true
if promise is in pending state
promise = ;promise; // -> truepromisepromise; // -> false
promise.isRejected()
####
Returns true
if the promise is in rejected state
promise;promise; // -> true
promise.isResolved()
####
Returns true
if the promise is in one of resolved or rejected states
promise = ; promise; // -> falsepromise;promise; // -> true promise = ;promise;promise; // -> true
Static API###
Promise.allFulfilled(promises)
####
Creates a new promise to be fulfilled when all given promises will be fulfilled. Promise will be rejected if any of given promises will be rejected
promise1 = ;promise1;promise2 = ; Promise; ;
Promise.allResolved(promises)
####
Creates a new promise to be resolved when all given promises will bew resolved
promise1 = ;promise1;promise2 = ; Promise; ;
Promise.create([result])
####
Creates a new promise and resolves it, if given value is thenable
Promise; // -> {Promise}
Promise.resolve([value])
####
Resolves value and returns a new promise
promise = Promise;
Promise.fulfill([result])
####
Fulfills a new promise with given result
Promise;
Promise.reject([reason])
####
Creates a new promise and rejects it with given reason
Promise;
Promise.when([result], [onFulfilled], [onRejected])
####
Creates a new promise to be resolved when result
will be resolved according to promise resolution procedure.
onFulfilled and onRejected callbacks can be passed.
Promise;
Promise.invoke(fn)
####
Calls the given function and resolves new promise with returned value
Promise