專案中常需將來源物件(source)的屬性複製到目標物件(target),且需支援「是否覆蓋同名屬性」的選項。本文解析原生實作 mix() 與 jQuery .extend() 的差異、用法與注意事項。
/**
* 將 source 所有可列舉屬性複製到 target
* @param {Object} target 目標物件
* @param {Object} source 來源物件
* @param {Boolean} isOverwrite false = 不覆蓋既有屬性;其他值 = 覆蓋
* @returns {Object} 回傳 target(鏈式呼叫)
*/
function mix(target, source, isOverwrite) {
if (!target || !source) return target;
for (const key in source) {
if (isOverwrite !== false || !(key in target)) {
target[key] = source[key];
}
}
return target;
}
const a = { x: 1, y: 2 };
const b = { y: 20, z: 30 };
mix(a, b, false); // 不覆蓋
console.log(a); // { x: 1, y: 2, z: 30 } ← y 保持原值
mix(a, b, true); // 覆蓋
console.log(a); // { x: 1, y: 20, z: 30 } ← y 被更新
const a = { aa: 1, ab: 2 };
const b = { ba: 1, bb: 2 };
$.extend(a, b); // 淺層合併,b 覆蓋 a 同名鍵
console.log(a); // { aa: 1, ab: 2, ba: 1, bb: 2 }
// 深層合併
const c = { nested: { val: 1 } };
const d = { nested: { val: 2, extra: 3 } };
$.extend(true, c, d);
console.log(c); // { nested: { val: 2, extra: 3 } }
| 特性 | mix() | $.extend() |
|---|---|---|
| 相依性 | 零相依 | 需載入 jQuery |
| 深層合併 | 不支援(需自行遞迴) | 支援 true 參數 |
| 多來源合併 | 單一來源 | 支援多個來源物件 |
| 覆蓋控制 | 布林旗標 | 永遠覆蓋(深層合併除外) |
| 回傳值 | target | 合併後的 target |
// 淺層合併(ES2015+)
const merged = { ...target, ...source }; // 後者覆蓋前者
Object.assign(target, source); // 修改 target
// 深層合併(ES2022+ 或 Lodash _.merge)
// structuredClone 只能複製,無法合併
mix() 或 Object.assign。$.extend(true, ...) 或 Lodash _.merge。