extend() 是 jQuery 中舉足輕重的函式,用途是擴展物件。它同時是外掛開發的基礎工具,也是 jQuery 內部擴充自身能力的手段——上一篇提到的 noConflict,正是用它掛上去的。

查閱 API 手冊會發現,extend 其實同時掛在 jQuery 與 jQuery.fn 上。內部雖然共用同一份實作,功能卻不同:
jQuery.extend():把兩個或多個物件合併進「第一個物件」。jQuery.fn.extend():把物件掛到 jQuery 的 prototype 上,藉此新增「實例方法」。對應到 jQuery 的靜態方法與實例方法之分,這兩者的差別就很清楚了:一個擴充類別本身,一個擴充由它產生的每一個物件。
// 擴充靜態方法,用 $.sayhello() 呼叫
jQuery.extend({
sayhello: function () {
console.log("Hello, This is jQuery Library");
}
});
$.sayhello();
// 擴充實例方法,用 $("selector").check() 呼叫
jQuery.fn.extend({
check: function () {
return this.each(function () { this.checked = true; });
},
uncheck: function () {
return this.each(function () { this.checked = false; });
}
});
$("input[type='checkbox']").check();
注意呼叫方式的差異:靜態方法直接接在 $ 後面,實例方法必須先選取元素。另外,extend 接受多個參數;只傳一個時,該物件的屬性會被附加到 jQuery(或 jQuery.fn)上;傳多個時,後者會覆寫前者。
jQuery.extend = jQuery.fn.extend = function () {
var options, name, src, copy, copyIsArray, clone,
target = arguments[0] || {},
i = 1,
length = arguments.length,
deep = false;
// 第一個參數是布林值時,代表要進行深拷貝
if (typeof target === "boolean") {
deep = target;
target = arguments[1] || {};
i = 2; // 跳過布林值與 target
}
// target 若是字串或其他型別,一律改成空物件
if (typeof target !== "object" && !jQuery.isFunction(target)) {
target = {};
}
// 只有一個參數時,被擴充的對象就是 this(jQuery 或 jQuery.fn)
if (length === i) {
target = this;
--i;
}
for (; i < length; i++) {
if ((options = arguments[i]) != null) { // 忽略 null / undefined
for (name in options) {
src = target[name];
copy = options[name];
if (target === copy) continue; // 防止循環引用
// 深拷貝:遞迴處理純物件與陣列
if (deep && copy && (jQuery.isPlainObject(copy) ||
(copyIsArray = jQuery.isArray(copy)))) {
if (copyIsArray) {
copyIsArray = false;
clone = src && jQuery.isArray(src) ? src : [];
} else {
clone = src && jQuery.isPlainObject(src) ? src : {};
}
target[name] = jQuery.extend(deep, clone, copy);
} else if (copy !== undefined) { // 不帶入 undefined
target[name] = copy;
}
}
}
}
return target;
};
這一大段程式碼,扣除「多參數合併」與「深拷貝」之後,本質其實非常樸素:
jQuery.extend = jQuery.fn.extend = function (obj) {
var target = this;
for (var name in obj) {
var copy = obj[name];
if (target === copy) continue; // 避免循環
if (typeof copy === 'undefined') continue; // 跳過未定義
target[name] = copy;
}
return target;
};
布林值優先。jQuery.extend(true, a, b) 這種寫法之所以成立,是因為開頭就檢查了 typeof target === "boolean",並把起始索引推到 2。
單參數時 target 變成 this。這一行解釋了為什麼同一份程式碼能同時服務靜態與實例兩種場景——呼叫者不同,this 就不同。
undefined 不覆寫,null 會覆寫。這是刻意的設計,讓「只傳想改的欄位」成為可能,同時保留「明確設為 null 清空值」的能力。
淺拷貝是預設。深拷貝需要顯式傳 true,因為遞迴有成本,而且多數場景只需要淺層合併。
把這幾個分支想通,寫 jQuery 外掛時就不必再為「方法該掛在哪裡」而猶豫了。