summaryrefslogtreecommitdiff
path: root/lib/dojo/promise/first.js.uncompressed.js
diff options
context:
space:
mode:
authorAndrew Dolgov <[email protected]>2013-03-18 10:26:24 +0400
committerAndrew Dolgov <[email protected]>2013-03-18 10:26:26 +0400
commitf0cfe83e3725f9a3928da97a6e3085e79cb25309 (patch)
tree4b0af188defaa807c7bc6ff3a101b41c9166c463 /lib/dojo/promise/first.js.uncompressed.js
parent9a2885da170ffd64358b99194095851a2d09c1b6 (diff)
upgrade dojo to 1.8.3 (refs #570)
Diffstat (limited to 'lib/dojo/promise/first.js.uncompressed.js')
-rw-r--r--lib/dojo/promise/first.js.uncompressed.js49
1 files changed, 49 insertions, 0 deletions
diff --git a/lib/dojo/promise/first.js.uncompressed.js b/lib/dojo/promise/first.js.uncompressed.js
new file mode 100644
index 000000000..863573fa1
--- /dev/null
+++ b/lib/dojo/promise/first.js.uncompressed.js
@@ -0,0 +1,49 @@
+define("dojo/promise/first", [
+ "../_base/array",
+ "../Deferred",
+ "../when"
+], function(array, Deferred, when){
+ "use strict";
+
+ // module:
+ // dojo/promise/first
+
+ var forEach = array.forEach;
+
+ return function first(objectOrArray){
+ // summary:
+ // Takes multiple promises and returns a new promise that is fulfilled
+ // when the first of these promises is fulfilled.
+ // description:
+ // Takes multiple promises and returns a new promise that is fulfilled
+ // when the first of these promises is fulfilled. Canceling the returned
+ // promise will *not* cancel any passed promises. The promise will be
+ // fulfilled with the value of the first fulfilled promise.
+ // objectOrArray: Object|Array?
+ // The promises are taken from the array or object values. If no value
+ // is passed, the returned promise is resolved with an undefined value.
+ // returns: dojo/promise/Promise
+
+ var array;
+ if(objectOrArray instanceof Array){
+ array = objectOrArray;
+ }else if(objectOrArray && typeof objectOrArray === "object"){
+ array = [];
+ for(var key in objectOrArray){
+ if(Object.hasOwnProperty.call(objectOrArray, key)){
+ array.push(objectOrArray[key]);
+ }
+ }
+ }
+
+ if(!array || !array.length){
+ return new Deferred().resolve();
+ }
+
+ var deferred = new Deferred();
+ forEach(array, function(valueOrPromise){
+ when(valueOrPromise, deferred.resolve, deferred.reject);
+ });
+ return deferred.promise; // dojo/promise/Promise
+ };
+});