jQuery原始碼學習之extend

盪漾發表於2018-07-28
jQuery原始碼

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;
};

相關文章