jQuery 對外只暴露了 $ 與 jQuery 兩個全域變數,多數情況下不至於衝突。但只要頁面同時載入了 Prototype、MooTools,或是某些自帶 $ 的廣告腳本與外掛,問題立刻就會出現——後載入的會把先載入的覆蓋掉。
noConflict 就是為了解這個問題而生,而且 $ 與 jQuery 兩種衝突它都能處理。
(function (window, undefined) {
var // 記錄 jQuery 被覆寫前的樣子
_jQuery = window.jQuery,
// 記錄 $ 被覆寫前的樣子
_$ = window.$,
jQuery.extend({
noConflict: function (deep) {
if (window.$ === jQuery) {
window.$ = _$;
}
if (deep && window.jQuery === jQuery) {
window.jQuery = _jQuery;
}
return jQuery;
}
});
}(window))
第一步,先快照。在 IIFE 進入時,立刻把當時的 window.jQuery 與 window.$ 存進閉包內的私有變數 _jQuery 與 _$。這兩個變數保存了「jQuery 執行之前」的狀態,是後續還原的依據。如果原本沒有其他函式庫,它們的值就是 undefined。
第二步,附加方法。這裡用 jQuery.extend 把 noConflict 掛成靜態方法,效果等同直接寫 jQuery.noConflict = function(){}。
第三步,條件判斷。為什麼要寫 window.$ === jQuery,而不是無條件把 window.$ 設回 _$?因為要保護「已經被其他人定義好的變數」。只有在全域 $ 確實還指向 jQuery 時,才代表這個佔位可以安全歸還;否則就該保持現狀,不要多手。
第四步,deep 參數。不傳參數時只處理 $;傳入 true 才連 jQuery 一起還原。實務上比較常見的寫法是 var jq = jQuery.noConflict();,把 jQuery 交給自己命名。
var $ = "String"; // 模擬其他函式庫先佔用了 $
var jq = jQuery.noConflict(); // 歸還 $
console.log($); // "String"
// 若少了 window.$ === jQuery 的判斷,
// 這裡會變成 undefined
var j = jq.noConflict(true); // 連 jQuery 一起歸還
console.log(jQuery); // 同樣會被 undefined 覆蓋掉(若無判斷)

整體邏輯可以濃縮成一句話:進入時先記住現場,離開時只在「東西確實還在原位」的情況下才歸還。noConflict 最後回傳的是函式庫內部的 jQuery 建構函式,之後就能像使用 $ 一樣自在。
補充一個實務提醒:noConflict() 必須在 jQuery 載入之後、衝突的函式庫載入之前或之後皆可,但要在「第一次使用 $ 之前」執行,順序安排錯了,前面的快照就失去意義。