源碼核心邏輯 (jQuery 1.8.3)
jQuery.extend = jQuery.fn.extend = function() {
var options, name, src, copy, copyIsArray, clone,
target = arguments[0] || {}, // 目標對象
i = 1,
length = arguments.length,
deep = false;
// 1. 處理深拷貝標誌:第一參為 boolean
if (typeof target === "boolean") {
deep = target;
target = arguments[1] || {};
i = 2;
}
// 2. 目標非物件/函數 → 初始化為空物件
if (typeof target !== "object" && !jQuery.isFunction(target)) {
target = {};
}
// 3. 單參數模式:擴展 jQuery 自身 (this)
if (length === i) {
target = this;
--i;
}
// 4. 遍歷來源對象
for (; i < length; i++) {
if ((options = arguments[i]) != null) {
for (name in options) {
src = target[name];
copy = options[name];
// 防止循環引用
if (target === copy) continue;
// 5. 深拷貝遞歸條件
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);
}
// 6. 淺拷貝:直接賦值(undefined 不覆蓋)
else if (copy !== undefined) {
target[name] = copy;
}
}
}
}
return target; // 返回修改後的目標對象
};
四種調用形式詳解
| 形式 | 簽名 | 用途 | 拷貝類型 |
| 單參數 | $.extend(src) | 擴展 jQuery/$.fn (插件開發) | 淺拷貝 |
| 雙參數 | $.extend(target, src) | 合併 src 到 target | 淺拷貝 |
| 三參數 | $.extend(true, target, src) | 深度合併 | 深拷貝 |
| 多參數 | $.extend(true, target, src1, src2...) | 多源深度合併,後者覆蓋前者 | 深拷貝 |
淺拷貝 vs 深拷貝 實測
淺拷貝:共享引用
var person = { languages: ['Java', 'C++'] };
$.extend(person); // 擴展到 $
$.languages.push('Python');
console.log(person.languages); // ["Java", "C++", "Python"] ← 原對象被修改!
深拷貝:獨立副本
var person = { languages: ['Java', 'C++'] };
$.extend(true, person); // 深度擴展到 $
$.languages.push('Python');
console.log(person.languages); // ["Java", "C++"] ← 原對象不受影響
console.log($.languages); // ["Java", "C++", "Python"]
目標對象合併優先級
var defaults = { a: 1, b: { x: 10 } };
var options1 = { b: { y: 20 }, c: 3 };
var options2 = { b: { z: 30 }, d: 4 };
// 淺拷貝:b 被 options1 完全覆蓋
$.extend(defaults, options1, options2);
// defaults = { a:1, b:{z:30}, c:3, d:4 } ← b.x 丟失,b.y 也被 options2 的 b 覆蓋
// 深拷貝:遞歸合併 b
$.extend(true, {}, defaults, options1, options2);
// 結果: { a:1, b:{x:10, y:20, z:30}, c:3, d:4 } ← 完美合併巢狀物件
陣列處理特殊規則
- 深拷貝時,陣列視為普通物件,**會合併索引**而非連接:
$.extend(true, { arr: [1,2] }, { arr: [3,4] });
// 結果: { arr: {0:3, 1:4, length:2} } ← 變成類陣列物件!
// 正確合併陣列請用: [...arr1, ...arr2] 或 concat
現代替代方案
| 方案 | 優點 | 缺點 |
Object.assign(target, ...srcs) | 原生、無依賴、淺拷貝 | 不支援深拷貝 |
_.merge (Lodash) | 深拷貝、處理陣列合併邏輯可配置 | 需引入庫 |
structuredClone(obj) (ES2022) | 原生深克隆、支援循環引用 | 不可合併多源 |
Spread {...a, ...b} | 語法簡潔、淺拷貝 | 不支援深拷貝 |
結語
jQuery.extend 以「遞歸深度合併 + 陣列特殊處理 + 循環引用保護」實現了強大的物件合併。理解其原理有助於正確選擇淺/深拷貝、避免陣列合併陷阱。現代專案推薦 Object.assign (淺) + structuredClone (深克隆) + lodash.merge (深合併) 組合,零依賴且語意明確。