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