jQuery.extend() 是整個 jQuery 的擴充基石,幾乎每個模組都靠它掛上自己的方法。它的原始碼寫得相當精緻,值得逐段讀。
deep 是布林值,表示是否進行深度合併,預設 false。透過這種方式可以在 jQuery 或 jQuery.fn 上添加新的屬性和方法,jQuery 的其他模組大都是這麼實作的。
給 jQuery 添加擴充時用 $.extend():
jQuery.extend({ add: function(a,b){ return a+b } })
// 使用:$.add(1,3) =====> 4;
給 jQuery 實例物件添加擴充時用 $.fn.extend():
$.fn.extend({ gys: function(){ $(this).css("color","red") } });
// 調用:$("div.guo").gys();

因為參數的個數是不確定的,所以原始碼沒有列出可接受的具體參數。

· options:指向某個源物件
· name:某個源物件的某個屬性名
· src:目標物件某個屬性的原始值
· copy:某個源物件某個屬性的值
· copyIsArray:指示 copy 是否為陣列
· clone:深度複製時原始值的修正值
· target:目標物件
· i:源物件的起始下標
· length:參數的個數,用於修正變數 target
· deep:是否執行深度複製

333~338 行:修正 target 與 i
如果第一個參數是布林值,則把 target 賦值給 deep,target 重新取值(變成第二個參數),此時 i 從原本的 1 變成 2。也就是說,源物件本來是從第二個參數開始的,現在變成從第三個參數開始。這段程式碼結合第 327 行來看就懂了:extend 在執行時,不管參數情況如何,先給 target 和 i 一組預設值,後面再依實際傳入情況修正。這是一種「先樂觀假設、再逐步校正」的寫法。
341~343 行:target 型別防護
如果目標物件 target 不是物件也不是函式,則強制設為 {}。這保證了後續賦值不會出錯。
346~349 行:length 與 i 相等的特殊情況
表示沒有傳入 obj1、obj2 之類的源物件。此時把 this(也就是 jQuery 或 jQuery.fn)作為目標物件,再把 i 減一,從而使傳入的物件當作源物件。這正是 $.extend({...}) 這種單參數寫法能運作的原因。

351 行起:主迴圈
i 表示開始源物件的下標,是非常巧妙的用法。353 行也很精彩——它把「取得源物件」和「判斷源物件」放在同一條敘述句中,只有源物件不為空時才會執行。
354~362 行:循環參照的防護
變數 src 是原始值,copy 是複製值。如果 target 和 copy 引用相同,為了避免迴圈時造成無限遞迴,因此不會覆蓋目標物件的同名屬性。如果註解掉第 360 行,下面的程式碼就會出問題:
var obj = {};
obj.n1 = obj;
$.extend(true, obj, {n2: obj});
在不同瀏覽器中會出現不同的報錯,但都無例外地卡屏很久——這就是沒有做參照檢查的下場。
365~372 行:深度合併的遞迴
如果是深度合併,且複製的 copy 是普通 JavaScript 物件或陣列,則遞迴合併。這也是 clone 與 copyIsArray 這兩個變數存在的目的——前者在遞迴時修正原始值以避免重複配置,後者則決定要用陣列合併還是的物件合併的邏輯。
378~380 行:淺合併的直接覆蓋
如果不是深度合併,並且 copy 不是 undefined,則直接覆蓋目標物件的同名屬性。注意這裡刻意排除了 undefined——這讓 $.extend(defaults, options) 在 options 的某個屬性為 undefined 時,不會把 defaults 的預設值破壞掉。
整段原始碼最值得學的,是那個「先給預設值、再依實際參數修正」的處理骨架。它讓一個函式能優雅地同時支援 extend(obj)、extend(obj1, obj2) 與 extend(true, obj1, obj2) 三種截然不同的呼叫形式,而不必寫成一堆 if-else 分支。