jQuery源码学习之extend

jQuery源码学习之extend

$.extend用于合并对象，可选择是否深复制。使用时，第一个参数为合并后的对象。如果要进行深拷贝，则参数1为true，参数2为要合并的目标对象。尽管jQuery官方文档明确指出第一个参数是false的调用情况并不支持，但是这个版本的源码中，判断第一个参数的类型虽有限定是boolean类型，但却未对其值真假加以限定。所以第一个参数是false也是可行的。

$.fn.extend({})用于拓展jq原型对象，使用只能传入一个对象，多用于jq插件定义。

调用方式

jQuery.extend( target [, object1 ] [, objectN ] )
Query.extend( [deep ], target, object1 [, objectN ] )
jQuery.fn.extend( object )

源码

jQuery.extend和jQuery.fn.extend指向同一个函数，在函数内部，对调用情况进行区分。首先判断第一个参数的类型，确定是否显式指定深复制。使用target保存合并对象的引用，如果target不是对象的，要指向空对象。

接着判断参数的个数，区别jQuery.extend或jQuery.fn.extend的调用。然后使用for循环，从第二个参数开始遍历，进行拷贝；拷贝时使用src保存target上的属性，copy保存被合并对象上的属性。使用for...in循环遍历属性名进行拷贝，拷贝时忽略对target自身引用，copy为空时也会被忽略，如果根据是否需要深拷贝来决定是否对object和array递归深拷贝。如果是浅拷贝，直接保存值或引用。

值得一提的是，遍历被合并对象时使用的是for...in循环，所以传入string和array类型的参数也会被遍历，在合并后对象中的属性名为索引。由于遍历参数是从target后的第一个参数开始，所以先传入的对象会被后传入对象的同名属性覆盖。

jQuery.extend = jQuery.fn.extend = function() {
    // target是对象或true，从第二个参数开始遍历
    var options, name, src, copy, copyIsArray, clone,
        target = arguments[ 0 ] || {},
        i = 1,
        length = arguments.length,
        deep = false;

    // Handle a deep copy situation
    // 第一个参数如果是boolean，表明显示指定是否深复制
    if ( typeof target === "boolean" ) {
        deep = target;

        // Skip the boolean and the target
        // 将target指向第一个参数，从第三个参数开始合并
        target = arguments[ i ] || {};
        i++;
    }

    // Handle case when target is a string or something (possible in deep copy)
    // 不是对象或函数，将target设置默认空
    if ( typeof target !== "object" && !jQuery.isFunction( target ) ) {
        target = {};
    }

    // Extend jQuery itself if only one argument is passed
    // 只有一个参数，即$.fn.extend({}),target指向jq原型
    if ( i === length ) {
        target = this;
        i--;
    }

    // 先传入的对象会被后传入对象的同名属性覆盖
    for ( ; i < length; i++ ) {

        // Only deal with non-null/undefined values
        // 保存当前的非空对象。
        if ( ( options = arguments[ i ] ) != null ) {

            // Extend the base object
            // 遍历，for...in会遍历数组或字符串
            // src为target属性值，copy为闯入对象的属性值
            for ( name in options ) {
                src = target[ name ];
                copy = options[ name ];

                // Prevent never-ending loop
                // 自身的属性指向自身，这种情况避免无限循环，跳过自身引用的复制
                if ( target === copy ) {
                    continue;
                }

                // Recurse if we're merging plain objects or arrays
                // 深复制时，调用$.extend递归调用。
                // 复制时保存属性的原始类型，只有对象或数组才必要进行深复制
                if ( deep && copy && ( jQuery.isPlainObject( copy ) ||
                    ( copyIsArray = Array.isArray( copy ) ) ) ) {

                    if ( copyIsArray ) {
                        copyIsArray = false;
                        clone = src && Array.isArray( src ) ? src : [];

                    } else {
                        clone = src && jQuery.isPlainObject( src ) ? src : {};
                    }

                    // Never move original objects, clone them
                    target[ name ] = jQuery.extend( deep, clone, copy );

                // Don't bring in undefined values
                // 浅复制，值非空直接复制或保存引用
                } else if ( copy !== undefined ) {
                    target[ name ] = copy;
                }
            }
        }
    }

    // Return the modified object
    return target;
};