Commit 6e066a4d authored by jaubourg's avatar jaubourg

Trims down deferred.js. The gist of it is from the magnificent @gibson042, I...

Trims down deferred.js. The gist of it is from the magnificent @gibson042, I just added some minor touches.
parent 87c83b04
...@@ -6,90 +6,82 @@ var // Static reference to slice ...@@ -6,90 +6,82 @@ var // Static reference to slice
jQuery.extend({ jQuery.extend({
Deferred: function( func ) { Deferred: function( func ) {
var doneList = jQuery.Callbacks( "once memory" ), var tuples = [
failList = jQuery.Callbacks( "once memory" ), // action, add listener, listener list
progressList = jQuery.Callbacks( "memory" ), [ "resolve", "done", jQuery.Callbacks("once memory") ],
[ "reject", "fail", jQuery.Callbacks("once memory") ],
[ "notify", "progress", jQuery.Callbacks("memory") ]
],
state = "pending", state = "pending",
lists = {
resolve: doneList,
reject: failList,
notify: progressList
},
promise = { promise = {
done: doneList.add,
fail: failList.add,
progress: progressList.add,
state: function() { state: function() {
return state; return state;
}, },
// Deprecated
isResolved: doneList.fired,
isRejected: failList.fired,
always: function() { always: function() {
deferred.done.apply( deferred, arguments ).fail.apply( deferred, arguments ); deferred.done( arguments ).fail( arguments );
return this; return this;
}, },
then: function( fnDone, fnFail, fnProgress ) { then: function( /* fnDone, fnFail, fnProgress */ ) {
var fns = arguments;
return jQuery.Deferred(function( newDefer ) { return jQuery.Deferred(function( newDefer ) {
jQuery.each( { jQuery.each( tuples, function( i, tuple ) {
done: [ fnDone, "resolve" ], var action = tuple[ 0 ],
fail: [ fnFail, "reject" ], fn = fns[ i ];
progress: [ fnProgress, "notify" ] // deferred[ done | fail | progress ] for forwarding actions to newDefer
}, function( handler, data ) { deferred[ tuple[1] ]( jQuery.isFunction( fn ) ?
var fn = data[ 0 ], function() {
action = data[ 1 ], var returned = fn.apply( this, arguments );
returned;
if ( jQuery.isFunction( fn ) ) {
deferred[ handler ](function() {
returned = fn.apply( this, arguments );
if ( returned && jQuery.isFunction( returned.promise ) ) { if ( returned && jQuery.isFunction( returned.promise ) ) {
returned.promise().done( newDefer.resolve ).fail( newDefer.reject ).progress( newDefer.notify ); returned.promise()
.done( newDefer.resolve )
.fail( newDefer.reject )
.progress( newDefer.notify );
} else { } else {
newDefer[ action + "With" ]( this === deferred ? newDefer : this, [ returned ] ); newDefer[ action + "With" ]( this === deferred ? newDefer : this, [ returned ] );
} }
}); } :
} else { newDefer[ action ]
deferred[ handler ]( newDefer[ action ] ); );
}
}); });
fns = null;
}).promise(); }).promise();
}, },
// Get a promise for this deferred // Get a promise for this deferred
// If obj is provided, the promise aspect is added to the object // If obj is provided, the promise aspect is added to the object
promise: function( obj ) { promise: function( obj ) {
if ( obj == null ) { return typeof obj === "object" ? jQuery.extend( obj, promise ) : promise;
obj = promise;
} else {
for ( var key in promise ) {
obj[ key ] = promise[ key ];
}
}
return obj;
} }
}, },
deferred, deferred = {};
key;
// Keep pipe for back-compat // Keep pipe for back-compat
promise.pipe = promise.then; promise.pipe = promise.then;
// Construct deferred // Add list-specific methods
deferred = promise.promise({}); jQuery.each( tuples, function( i, tuple ) {
var list = tuple[ 2 ], stateString;
for ( key in lists ) { // promise[ done | fail | progress ] = list.add
deferred[ key ] = lists[ key ].fire; promise[ tuple[1] ] = list.add;
deferred[ key + "With" ] = lists[ key ].fireWith;
}
// Handle state // Handle state
deferred.done( function() { if ( i < 2 ) {
state = "resolved"; stateString = tuple[ 0 ].replace( /e?$/, "ed" );
}, failList.disable, progressList.lock ).fail( function() { list.add(function() {
state = "rejected"; state = stateString;
}, doneList.disable, progressList.lock ); tuples[ i ^ 1 ][ 2 ].disable();
tuples[ 2 ][ 2 ].lock();
});
promise[ "isR" + stateString.substr( 1 ) ] = list.fired;
}
// deferred[ resolve | reject | notify ] = list.fire
deferred[ tuple[0] ] = list.fire;
deferred[ tuple[0] + "With" ] = list.fireWith;
});
// Make the deferred a promise
promise.promise( deferred );
// Call given func if any // Call given func if any
if ( func ) { if ( func ) {
...@@ -101,45 +93,50 @@ jQuery.extend({ ...@@ -101,45 +93,50 @@ jQuery.extend({
}, },
// Deferred helper // Deferred helper
when: function( firstParam ) { when: function( subordinate /* , ..., subordinateN */ ) {
var args = sliceDeferred.call( arguments ), var i = 0,
i = 0, resolveValues = sliceDeferred.call( arguments ),
length = args.length, length = resolveValues.length,
pValues = new Array( length ), progressValues = new Array( length ),
count = length,
pCount = length, // the count of uncompleted subordinates
deferred = length <= 1 && firstParam && jQuery.isFunction( firstParam.promise ) ? remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0,
firstParam :
jQuery.Deferred(), // the master Deferred. If resolveValues consist of only a single Deferred, just use that.
promise = deferred.promise(); deferred = remaining === 1 ? subordinate : jQuery.Deferred(),
function resolveFunc( i ) { promise = deferred.promise(),
return function( value ) {
args[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments ) : value; // Update function for both resolve and progress values
if ( !( --count ) ) { updateFunc = function( i, arr ) {
deferred.resolveWith( deferred, args ); return function( value ) {
} arr[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments ) : value;
}; if( arr === progressValues ) {
} deferred.notifyWith( promise, arr );
function progressFunc( i ) { } else if ( !( --remaining ) ) {
return function( value ) { deferred.resolveWith( promise, arr );
pValues[ i ] = arguments.length > 1 ? sliceDeferred.call( arguments ) : value; }
deferred.notifyWith( promise, pValues ); };
}; };
}
// add listeners to Deferred subordinates; treat others as resolved
if ( length > 1 ) { if ( length > 1 ) {
for ( ; i < length; i++ ) { for ( ; i < length; i++ ) {
if ( args[ i ] && args[ i ].promise && jQuery.isFunction( args[ i ].promise ) ) { if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) {
args[ i ].promise().done( resolveFunc(i) ).fail( deferred.reject ).progress( progressFunc(i) ); resolveValues[ i ].promise()
.done( updateFunc( i, resolveValues ) )
.fail( deferred.reject )
.progress( updateFunc( i, progressValues ) );
} else { } else {
--count; --remaining;
} }
} }
if ( !count ) {
deferred.resolveWith( deferred, args );
}
} else if ( deferred !== firstParam ) {
deferred.resolveWith( deferred, length ? [ firstParam ] : [] );
} }
// if we're not waiting on anything, resolve the master
if ( !remaining ) {
deferred.resolveWith( deferred, resolveValues );
}
return promise; return promise;
} }
}); });
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment