$.extend() 是 jQuery 裡最常被用來合併設定的工具函式,插件開發時幾乎一定會用到。它的原型看似簡單,但「會不會改到原物件」以及「要不要深拷貝」這兩個問題,是很多人踩過的坑。
把 src1、src2、src3… 合併進 dest,回傳值為合併後的 dest。請注意:這個方法會直接修改 dest 的結構。
如果你想要合併結果,卻不希望動到 dest,可以把空物件 {} 當作第一個參數:
var newSrc = $.extend({}, src1, src2, src3...);
這樣 src1、src2、src3 會被合併進一個全新的物件,結果回傳給 newSrc,原本的物件完全不受影響。
實際例子:
var result = $.extend({}, {name: "Tom", age: 21}, {name: "Jerry", sex: "Boy"});
合併結果:
result = {name: "Jerry", age: 21, sex: "Boy"}
也就是說,後面的參數若與前面有同名屬性,會直接覆蓋前面的值。這個「後者優先」的規則,正是插件用「使用者設定覆蓋預設值」的基礎。
第一個參數如果是布林值,代表要不要進行「深度拷貝(深合併)」,其餘參數用法與前面相同。
var result = $.extend(true, {},
{ name: "John", location: {city: "Boston", county: "USA"} },
{ last: "Resig", location: {state: "MA", county: "China"} }
);
src1 有嵌套子物件 location,src2 也有。第一個參數為 true 時,兩者的子屬性會逐一合併:
result = {
name: "John",
last: "Resig",
location: { city: "Boston", state: "MA", county: "China" }
}
city 來自 src1,state 來自 src2,county 則被後者覆蓋。
var result = $.extend(false, {},
{ name: "John", location: {city: "Boston", county: "USA"} },
{ last: "Resig", location: {state: "MA", county: "China"} }
);
淺合併時不會深入子物件,整個 location 直接被 src2 的版本取代:
result = { name: "John", last: "Resig", location: {state: "MA", county: "China"} }
原本 src1 裡的 city 就這樣消失了。
options = $.extend({}, defaults, userOptions); 這是最經典的用法,既合併又不污染 defaults。style: {color, size}),就必須用 $.extend(true, {}, ...),否則使用者的設定會把整組預設值吃掉。{...a, ...b} 做淺合併,需要深合併時則用 structuredClone(),語意更清楚。