jQuery提供的when方法可以管理多个Deferred对象。打比方说如果你创建了多个Deferred对象,这个时候你想等所有Deferred调用完毕之后执行一段代码,这个时候我们就可以使用when来实现。
源码
/**源码3089行**/
when: function( subordinate /* , ..., subordinateN */ ) {
var i = 0,
resolveValues = core_slice.call( arguments ),
length = resolveValues.length,
/**源码3095行**/
remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0,
/**源码3098行**/
deferred = remaining === 1 ? subordinate : jQuery.Deferred(),
// Update function for both resolve and progress values
updateFunc = function( i, contexts, values ) {
return function( value ) {
contexts[ i ] = this;
values[ i ] = arguments.length > 1 ? core_slice.call( arguments ) : value;
if( values === progressValues ) {
deferred.notifyWith( contexts, values );
} else if ( !( --remaining ) ) {
deferred.resolveWith( contexts, values );
}
};
},
progressValues, progressContexts, resolveContexts;
/**源码3116行**/
if ( length > 1 ) {
progressValues = new Array( length );
progressContexts = new Array( length );
resolveContexts = new Array( length );
for ( ; i < length; i++ ) {
if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) {
resolveValues[ i ].promise()
.done( updateFunc( i, resolveContexts, resolveValues ) )
.fail( deferred.reject )
.progress( updateFunc( i, progressContexts, progressValues ) );
} else {
--remaining;
}
}
}
/**源码3133行**/
if ( !remaining ) {
deferred.resolveWith( resolveContexts, resolveValues );
}
return deferred.promise();
}
原理
when的原理:
利用remaining来记录Deferred的数量,如果传入的不是Deferred对象,则不记录(源码中直接进行remaining-1操作)。当Deferred执行成功之后会将remaining进行-1操作,当最后一个Deferred执行完毕(成功)之后(remaining等于0的时候)这个时候我们就会触发when方法里面创建的Deferred对象。如果遇到其中一个Deferred调用了失败方法,则直接调用when的reject。如果传入的参数没有一个是Deferred对象,则直接调用回调函数。
解释
首先来看源码3095行和源码3098行,这里的意思是值如果传入的参数如果只有一个并且是Deferred对象,则直接使用这个Deferred对象,如果传入的这个参数不是Deferred对象或者存在多个参数则直接创建一个新的Deferred对象。
源码3116行判断如果参数个数大于1个的时候,这个时候我们首先来循环这些参数判断是否是Deferred对象,如果不是则将remaining直接进行-1操作,如果是Deferred对象,这个时候我们可以看到done和progress都调用了updateFunc函数。在updateFunc函数里面进行了判断如果第三个参数是progressValues则直接调用我们创建的deferred的notifyWith,所以绑定在when后面的progress可能会触发多次根据参数中Deferred对象调用progress的次数而定。如果是done触发的
updateFunc方法,这个时候我们会先将remaining进行-1操作,如果remaining等于0的时候则直接触发deferred的resolveWith。
源码3133行的意思就是 如果我们传入的参数全都不是Deferred对象,这个时候我们就直接触发成功的方法。最后return deferred.promise();不给外部提供修改状态的方法。
用法
var def1 = $.Deferred();
setTimeout(function(){
def1.resolve();
}, 1000);
$.when(def1).done(function(){
console.log('全部成功');
}).fail(function(){
console.log('有失败');
})
//1秒中之后会调用成功