寫過 jQuery 的人,大概都寫過 $(function(){}) 或 $(document).ready(function(){})。它好用到讓人很少去想:jQuery 究竟是怎麼知道「DOM 已經準備好了」?本文以 jQuery 1.12.0 的原始碼為例,把這件事拆開來看。
window.onload 要等到 DOM 樹建立完成、並且頁面中所有外部資源(圖片、樣式表、iframe 等)都下載完畢才會觸發。document.ready 則是 DOM 樹一建好就執行,不等圖片。
這個差別在實務上很關鍵:如果頁面掛了大量圖片,onload 可能拖到好幾秒後才觸發,這段期間使用者點擊按鈕卻沒有任何反應,因為事件還沒綁上——對體驗是種傷害。這也是 ready 存在的理由。
jQuery.ready.promise = function( obj ) {
if ( !readyList ) {
readyList = jQuery.Deferred();
// 處理 $(document).ready() 在瀏覽器事件已經發生之後才被呼叫的情況
// 我們曾經嘗試在此使用 readyState "interactive",
// 但會造成類似 ChrisS 發現的問題:
// https://bugs.jquery.com/ticket/12282#comment:15
if ( document.readyState === "complete" ) {
// 非同步處理,讓其他 script 有機會延後 ready
window.setTimeout( jQuery.ready );
// 標準瀏覽器支援 DOMContentLoaded
} else if ( document.addEventListener ) {
document.addEventListener( "DOMContentLoaded", completed );
// 保底方案,一定會成功
window.addEventListener( "load", completed );
// 走 IE 的事件模型
} else {
// 確保在 onload 之前觸發,也許稍晚,但對 iframe 同樣安全
document.attachEvent( "onreadystatechange", completed );
window.attachEvent( "onload", completed );
// 若是 IE 且不在 frame 中,持續輪詢檢查文件是否就緒
var top = false;
try {
top = window.frameElement == null && document.documentElement;
} catch ( e ) {}
if ( top && top.doScroll ) {
( function doScrollCheck() {
if ( !jQuery.isReady ) {
try {
// 技巧來自 Diego Perini
// https://javascript.nwbox.com/IEContentLoaded/
top.doScroll( "left" );
} catch ( e ) {
return window.setTimeout( doScrollCheck, 50 );
}
detach(); // 移除所有 DOM ready 事件
jQuery.ready(); // 執行等待中的函式
}
} )();
}
}
}
return readyList.promise( obj );
};
從這段程式碼可以看出,jQuery 一共動用了四種手段來判斷 DOM 是否就緒:document.readyState、DOMContentLoaded 事件、onreadystatechange 事件,以及 IE 專屬的 doScroll 技巧。以下逐一說明。
readyState 是 document 的屬性,回報目前文件的載入狀態,可能的值有四種:
uninitialized:尚未開始載入。
loading:載入中。
interactive:文件已載入完成,可與使用者互動,但圖片等資源仍在下載。
complete:文件與所有資源都載入完成。
所以判斷 document.readyState === "complete" 就能確認 DOM 已就緒。但原始碼註解(第 6–11 行)提到 ChrisS 發現了一個特殊問題,因此這裡執行 jQuery.ready 時刻意「延遲一下」。
仔細看會發現程式碼裡並沒有寫出延遲時間——setTimeout(jQuery.ready) 少了第二個參數。這是因為不指定延遲時,瀏覽器會依當前的環境與系統負擔,自行給定一個最小延遲值,剛好達到「讓出一個事件循環」的效果。

這是基於標準的做法。當 HTML 被完整解析、DOM 樹建構完成時,瀏覽器就會觸發 DOMContentLoaded,此時不等圖片、不等樣式表下載結束。因此在支援標準的瀏覽器中,只要監聽這個事件就能準確掌握 DOM 就緒的時機,這也是現代瀏覽器走的主要分支。
不支援標準的老 IE 則走 onreadystatechange。這個名字如果用過 Ajax 應該很熟悉——在 IE 中它是「私有」的,幾乎所有元素都有這個事件;而 W3C 標準裡只有 XMLHttpRequest 物件才有。當 readyState 變成 complete 時,即可視為 DOM 樹載入完成。
既然 onreadystatechange 已經能判斷,為什麼還需要 Diego Perini 提出的 doScroll 技巧?
因為 onreadystatechange 等的是 complete,而 complete 的定義包含「所有資源都載入完成」。也就是說,只要頁面上還有一張圖沒下載完,狀態就不會是 complete, ready 反而會被拖到比 onload 還晚。這顯然不是我們想要的。
doScroll 的原理很樸素:在 DOM 尚未建構完成時呼叫 doScroll() 會丟出例外;一旦 DOM 足夠就緒,呼叫便不再報錯。於是只要用 try...catch 包住它,並在失敗時每 50 毫秒重試一次,就能得到一個不受圖片影響的就緒判斷。
jQuery 的 ready 之所以看起來「哪個瀏覽器都能用」,靠的不是單一魔法,而是一層一層的向下相容:先看 readyState 是否已完成,再依能力偵測分別掛上標準事件或 IE 私有事件,最後用 doScroll 輪詢補上老 IE 的漏洞。理解這條鏈條,對排查「事件沒綁上」這類老問題很有幫助。