$.extend() 是 jQuery 核心工具方法,廣泛用於選項合併、預設值填充、物件複製、插件配置管理。本文系統解析其三種呼叫簽名、淺/深拷貝行為差異、陷阱與插件開發實戰模式。
$.extend(target, source1, source2, ...);
// 返回合併後的 target (原 target 被修改)
const merged = $.extend({}, source1, source2, source3);
// {} 作為空目標,來源物件保持不變
$.extend(true, target, source1, source2, ...);
// true → 深度遞迴合併巢狀物件/陣列
// false (預設) → 淺拷貝,僅第一層屬性覆蓋
const defaults = {
user: { name: 'Guest', prefs: { theme: 'light' } },
items: [1, 2]
};
const options = {
user: { name: 'Admin', prefs: { lang: 'zh' } },
items: [3, 4]
};
// 淺拷貝 (預設)
const shallow = $.extend({}, defaults, options);
/* 結果:
{
user: { name: 'Admin', prefs: { lang: 'zh' } }, // 整個 user.prefs 被替換!
items: [3, 4] // 陣列整個替換
}
*/
// 深拷貝
const deep = $.extend(true, {}, defaults, options);
/* 結果:
{
user: {
name: 'Admin',
prefs: { theme: 'light', lang: 'zh' } // prefs 合併!
},
items: [3, 4] // 陣列仍整個替換 (jQuery 不合併陣列元素)
}
*/
| 情況 | 行為 | 說明 |
|---|---|---|
後方來源屬性為 undefined | 忽略,不覆蓋 | 可用於「選填配置」 |
| 陣列合併 | 整個替換 | 不合併元素,非深度合併 |
| 循環引用 | 拋錯 / 無限遞迴 | jQuery 無內建檢測,需自行處理 |
| 原型鏈屬性 | 不複製 | 僅枚舉自有屬性 |
null/undefined 來源 | 忽略 | 安全 |
;(function($) {
$.fn.myPlugin = function(options) {
// 1. 定義預設值
const defaults = {
color: 'blue',
speed: 300,
easing: 'swing',
callbacks: {
onStart: $.noop,
onComplete: $.noop
}
};
// 2. 深度合併用戶選項 (不修改 defaults)
const settings = $.extend(true, {}, defaults, options);
// 3. 使用 settings
return this.each(function() {
const $el = $(this);
$el.animate({ color: settings.color }, settings.speed, settings.easing,
() => settings.callbacks.onComplete.call(this));
});
};
})(jQuery);
// 使用
$('.box').myPlugin({
color: 'red',
callbacks: { onComplete: () => console.log('Done!') }
// speed, easing, callbacks.onStart 自動使用預設值
});
function mergeArrays(target, source) {
// 策略 1:替換 (jQuery 預設)
// 策略 2:串聯
return target.concat(source);
// 策略 3:去重串聯
return [...new Set([...target, ...source])];
// 策略 4:按索引合併物件
return source.map((item, i) => $.extend(true, {}, target[i], item));
}
// 自定義深度合併支援陣列策略
function deepMerge(target, source, arrayStrategy = 'replace') {
// 實作略...
}
| 方法 | 深拷貝 | 陣列合併 | 備註 |
|---|---|---|---|
$.extend(true, {}, ...) | ✅ | 替換 | jQuery 依賴 |
Object.assign({}, ...) | ❌ 淺層 | 替換 | ES6 原生 |
{...a, ...b} | ❌ 淺層 | 替換 | ES2018 展開語法 |
lodash.merge() | ✅ | 替換 | 功能最全、體積大 |
deepmerge (npm) | ✅ | 可配置 | 輕量、專注合併 |
structuredClone() | ✅ 完整克隆 | N/A | 現代原生、不合併 |
$.extend(defaults, options) 會汙染預設值 → ✅ $.extend(true, {}, defaults, options)lodash.mergeWith 自定義function extend() {
const args = Array.from(arguments);
let deep = false, target = {}, i = 0;
if (typeof args[0] === 'boolean') { deep = args.shift(); }
target = args.shift() || {};
args.forEach(source => {
if (!source) return;
Object.keys(source).forEach(key => {
const srcVal = source[key];
if (srcVal === undefined) return;
if (deep && isPlainObject(srcVal)) {
target[key] = extend(true,
isPlainObject(target[key]) ? target[key] : {},
srcVal
);
} else if (deep && Array.isArray(srcVal)) {
target[key] = srcVal.slice(); // 陣列淺拷貝
} else {
target[key] = srcVal;
}
});
});
return target;
}
$.extend() 雖非標準 API,但其「選項合併」語意極契合插件開發。理解其深/淺拷貝邊界,能避免配置汙染、狀態異常等隱蔽 Bug。