寫外掛或可設定元件時,extend 幾乎是標配。它最常見的用法是把使用者傳入的設定合併到預設值上。
原型如下:
var v = $.extend(dest, src1, src2, [, src3...]);
作用是把 src1、src2、src3 合併進 dest 並回傳合併後的 dest。
先定義預設值與使用者設定:
var defaut = {
'selector' : 'select',
'default' : '默認值',
'backcolor' : '#85e137',
'forecolor' : '#000'
};
var src = {
'selector' : 'ss',
'default' : '笑話',
'backcolor' : '#fff',
'forecolor' : 'red'
};
直覺的寫法是把預設值放在第一個參數:
var v = $.extend(defaut, src);
這裡藏著一個嚴重的副作用:extend 會直接修改第一個參數。也就是說 defaut 本身被覆寫成了這次合併的結果。下次再呼叫同一段邏輯時,你拿到的「預設值」已經是上一輪被使用者改過的內容,不再是真正的預設值。這個 bug 在元件被同一頁面的多個實例使用時特別容易爆發。
var v = $.extend({}, defaut, src);
把空物件 {} 放在第一個參數作為接收者,預設值退居為第一個來源。結果一樣是合併後的設定物件,但 defaut 完全沒有被更動,可以放心重複使用。
extend 預設是淺合併,若設定值中有巢狀物件,改動 v 的內部屬性仍會影響到 defaut。需要獨立副本時加上第一個參數 true:
var v = $.extend(true, {}, defaut, src);
現代寫法則可用空物件展開語法達成同樣效果,意圖更明顯:
var v = { ...defaut, ...src };
記住這個原則就不會踩坑:extend 的第一個參數永遠要是「丟棄用的容器」,而不是你要保留的資料。