研究 jQuery 原始碼常常會有一種「每個字母都認識,連起來不知道是什麼」的挫折感,ready() 的實作就是經典案例。本文把它的運作機制拆開來講,順便釐清一個很多人一輩子沒搞懂的差別:ready 和 window.onload 根本不是同一件事。
window.onload 要等頁面上所有資源都下載完成才觸發,包含圖片、iframe、廣告腳本。只要有一張大圖或一個慢的外部資源,它就會遲遲不觸發。
DOM Ready 則是HTML 結構解析完成就觸發,不等圖片。這才是我們真正想要的時機——DOM 已經可以操作了,為什麼要等圖片?jQuery 的 ready() 實作的就是這件事。
但要注意:它並不是 window.onload 或 document.onload 的包裝,而是靠標準 W3C 的 DOM 事件加上對 IE 缺陷的變通手法拼出來的。
DOMContentLoaded = function() {
// 取消事件監聽,執行 ready
if (document.addEventListener) {
document.removeEventListener("DOMContentLoaded", DOMContentLoaded, false);
jQuery.ready();
} else if (document.readyState === "complete") {
document.detachEvent("onreadystatechange", DOMContentLoaded);
jQuery.ready();
}
};
邏輯很直白:事件觸發後先把自己從監聽列表移除(避免重複執行),再呼叫真正的 jQuery.ready()。
jQuery.ready.promise = function(obj) {
if (!readyList) {
readyList = jQuery.Deferred();
// 情況一:文件已經 complete,直接排入佇列
if (document.readyState === "complete") {
// 注意:部分瀏覽器 setTimeout 的最小延遲是 4ms,不能寫 0
setTimeout(jQuery.ready);
}
// 情況二:標準瀏覽器,監聽 DOMContentLoaded
else if (document.addEventListener) {
document.addEventListener("DOMContentLoaded", DOMContentLoaded, false);
// 保險:window load 時也會呼叫一次。
// 因為 ready 內部有 isReady 旗標,第二次呼叫會被 return 中斷,
// 所以掛兩個監聽不會重複執行。
window.addEventListener("load", jQuery.ready, false);
}
// 情況三:低版本 IE 的變通做法
else {
document.attachEvent("onreadystatechange", DOMContentLoaded);
window.attachEvent("onload", jQuery.ready);
var top = false;
try {
top = window.frameElement == null && document.documentElement;
} catch (e) {}
if (top && top.doScroll) { // 排除 iframe 的情況
(function doScrollCheck() {
if (!jQuery.isReady) {
try {
// 利用 IE 的缺陷:DOM 未就緒時呼叫 doScroll 會丟例外
top.doScroll("left");
} catch (e) {
// IE 的 onreadystatechange 不可靠,只能重試
return setTimeout(doScrollCheck, 50);
}
jQuery.ready();
}
})();
}
}
}
return readyList.promise(obj);
};
低版本 IE 的 onreadystatechange 判斷不準,會提早或延後觸發。工程師找到一個巧妙的替代品:document.documentElement.doScroll("left") 這個方法在 DOM 完全就緒前呼叫會丟出例外,就緒後則正常執行。於是用 try/catch 當探針,每 50 毫秒試一次,成功就代表可以跑 ready 了。
這段程式碼還刻意檢查 window.frameElement == null,因為在 iframe 裡 doScroll 的行為會出問題,必須跳過。
ready: function(wait) {
if (wait === true ? --jQuery.readyWait : jQuery.isReady) {
// 已完成載入且已執行過 ready,直接返回
return;
}
if (!document.body) {
// body 都還不存在,稍等一下再試
return setTimeout(jQuery.ready);
}
jQuery.isReady = true; // 標記 ready 已執行,確保只跑一次
if (wait !== true && --jQuery.readyWait > 0) {
return;
}
readyList.resolveWith(document, [jQuery]);
if (jQuery.fn.trigger) {
jQuery(document).trigger("ready").off("ready");
}
};
幾個值得注意的地方:
jQuery.isReady 是 idempotency 的關鍵。無論前面掛了多少個監聽器,這個旗標保證回呼只會真正執行一次。
readyWait 支援「延後 ready」。jQuery.holdReady(true) 就是靠遞增這個計數器,讓 ready 等你手動放行,這在需要等某個非同步設定完成時很好用。
if (!document.body) return setTimeout(...) 是最後一道防線。如果整份文件連 body 都還沒解析出來,再等一拍。
用 Deferred 串接回呼。所以 ready() 才能用 $.when() 那套 Promise 語法來組合,這也是 jQuery 1.8 之後的設計。
讀完這段原始碼,你會發現一件很有意思的事:現代瀏覽器只需要一行 DOMContentLoaded 就解決了,剩下百分之八十的程式碼都是在跟十幾年前的 IE 搏鬥。那些看似優雅的設計,背後往往是無數個瀏覽器 bug 逼出來的結果。
實務上的結論很簡單:ready() 該用就用,不用擔心效能;但如果你把 script 放在 body 尾端,其實連它都可以省下來。