「把來源物件 s 的所有屬性搬運到目標物件 r」是很基礎的需求。原生 JavaScript 與 jQuery 各有做法,但兩者在「是否覆蓋既有屬性」這件事上有關鍵差異,值得留意。
/**
* 將所有 s 的屬性複製給 r
* @param r {Object} 目標物件
* @param s {Object} 來源物件
* @param is_overwrite {Boolean} 若指定為 false,則不覆蓋 r 中已有的值;
* 其他值(含 undefined)都表示 s 中的同名屬性會覆蓋 r
*/
function mix(r, s, is_overwrite) {
if (!s || !r) return r;
for (var p in s) {
if (is_overwrite !== false || !(p in r)) {
r[p] = s[p];
}
}
return r;
}
邏輯很直白:走訪來源物件的所有可列舉屬性,視 is_overwrite 決定是否寫入。
var a = { aa: 1, ab: 2 };
var b = { ba: 1, bb: 2 };
$.extend(a, b);
console.info(a); // { aa: 1, ab: 2, ba: 1, bb: 2 }
一行搞定。$.extend 還有兩個常用變體:
$.extend(a, b, c); // 可串接多個來源
var merged = $.extend({}, a, b); // 傳空物件當目標 → 不改到 a,回傳新物件
$.extend(true, a, b); // 第一個參數為 true → 深層(遞迴)合併
屬性過濾規則不同。for...in 會一併列舉原型鏈上的可列舉屬性,因此上面的 mix() 若來源物件繼承了什麼,那些屬性也會被搬過來。要只搬自身屬性,請加判斷:
for (var p in s) {
if (Object.prototype.hasOwnProperty.call(s, p)) { r[p] = s[p]; }
}
Symbol 屬性會漏掉。兩種寫法都不處理 Symbol 鍵。
只複製可列舉屬性。用 Object.defineProperty 設為不可列舉的屬性不會被搬。
淺拷貝與深拷貝。不論哪種寫法,預設都是淺拷貝——若屬性值是物件,複製的是引用,改一邊會影響另一邊:
var a = { nested: { x: 1 } };
var b = {};
Object.assign(b, a);
b.nested.x = 99;
console.log(a.nested.x); // 99 ← 被連帶修改
// 淺合併
var merged = Object.assign({}, a, b);
// 物件展開語法(更簡潔)
var merged2 = { ...a, ...b };
// 深合併:使用 structuredClone(現代瀏覽器與 Node.js 17+ 支援)
var deep = structuredClone(a);
// 或 JSON 往返(限制:會丟掉 undefined、函式、Date、Map、循環引用)
var deep2 = JSON.parse(JSON.stringify(a));
實務建議:新專案直接用 Object.assign 或展開語法即可,不必自幹 mix()。若需要真正的深合併,structuredClone 是目前最可靠的原生選項,能正確處理循環引用與大多數內建型別。