jQuery-v2.0.3源码浅析05-when

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秒中之后会调用成功