jQuery.extend({

    // Deferred helper

    // 参数为Promise对象，我们称作：给定的Promise对象

    // when函数内部的deferred对象，我们称作：由when生成的Promise对象

    when: function( subordinate /* , ..., subordinateN */ ) {

        var i = 0,

            resolveValues = core_slice.call( arguments ),

            length = resolveValues.length,

            // the count of uncompleted subordinates

            // 用来存储给定的未执行(解决)的Promise对象的个数

            remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0,

            // the master Deferred. If resolveValues consist of only a single Deferred, just use that.

            // 我们称deferred为when生成的Promise对象

            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;

                    // 如果给定的任意一个Promise对象未执行或拒绝，则通知由when生成的Promise对象为pending状态

                    // 注：contexts是由所有给定的Promise对象组成的数组，

                    // values是由处理所有给定的Promise对象的回调的参数组成的数组

                    if( values === progressValues ) {

                        deferred.notifyWith( contexts, values );

                    }

                    // 如果给定的Promise对象已执行(解决)，且当未执行的Promise对象个数为0，

                    // 即:给定的所有Promise对象都已执行(解决)，则立即执行由when生成的Promise对象

                    // 注：contexts是由所有给定的Promise对象组成的数组，

                    // values是由处理所有给定的Promise对象的回调的参数组成的数组(请看实例1)

                    else if ( !( --remaining ) ) {

                        deferred.resolveWith( contexts, values );

                    }

                };

            },

            progressValues, progressContexts, resolveContexts;

        // add listeners to Deferred subordinates; treat others as resolved

        if ( length > 1 ) {

            progressValues = new Array( length );

            progressContexts = new Array( length );

            // resolveValues = core_slice.call( arguments ) // 别忘了最上面的这行代码

            resolveContexts = new Array( length );

            for ( ; i < length; i++ ) {

                // 如果给定when的参数是一个Promise对象，则通知由when生成的Promise对象，通知什么，如何通知？

                // 如果给定的Promise对象已执行，则执行由when生成的Promise对象(要等到所有给定Promise对象全部执行)

                // 如果给定的任意一个Promise对象已拒绝，则拒绝由when生成的Promise对象

                // 如果未执行或拒绝，默认是pending状态

                if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) {

                    resolveValues[ i ].promise()

                        .done( updateFunc( i, resolveContexts, resolveValues ) )

                        .fail( deferred.reject )

                        .progress( updateFunc( i, progressContexts, progressValues ) );

                }

                // 如果给定的不是一个Promise对象，那么负责减一

                else {

                    --remaining;

                }

            }

        }

        // if we're not waiting on anything, resolve the master

        // 如果传递给when的参数都不是递延对象，则执行由when生成的Promise对象

        if ( !remaining ) {

            // resolveContexts为一个空数组new Array( length )，resolveValues是由when参数组成的一个数组

            deferred.resolveWith( resolveContexts, resolveValues );

        }

        return deferred.promise();

    }

});

var promiseA = $.Deferred();

var promiseB = $.Deferred();

var doneFn = function(arg){

    console.log(arg);

};

promiseA.done(doneFn);

promiseB.done(doneFn);

promiseA.resolve('A'); // 'A'

promiseB.resolve('B'); // 'B'

var whenFn = function(arg1, arg2){

    console.log(this[0] === promiseA.promise()); // true

    console.log(this[1] === promiseB.promise()); // true

    console.log('promise' + arg1 + ', promise' + arg2 + ' All done!');

};

var whenPromise = jQuery.when(promiseA, promiseB);

whenPromise.done(whenFn); // true true 'promiseA, promiseB All done!'