// 定義在 jQuery.fn.ready
$(document).ready(handler);
// 和上一個是同一個,不推薦
$().ready(handler);
// 單獨在 jQuery 對象中處理
$(handler);
// 以上這個形式的定義:
if(jQuery.isFunction(selector) {
return rootjQuery.ready(selector);
}
三種寫法最終都歸結到同一處:jQuery.fn.ready(fn)。
ready: function(fn) {
// 綁定事件到 DOM 上
jQuery.bindReady();
// 觸發回調函數
readyList.done(fn);
// 返回 jQuery 對象
return this;
}
值得注意的是,jQuery 內部並不只是保存一個 fn 的引用,這裡用到了 Deferred 機制。在 75 行處為 jQuery 物件定義了 readyList 成員,並在 442 行的 bindReady 函式中初始化:
if(readyList) {
return;
}
readyList = jQuery._Deferred();
bindReady 除了初始化 readyList,另一項工作是把瀏覽器的事件綁定差異收攏:IE 使用 attachEvent,其他瀏覽器使用 addEventListener。這兩步完成後,ready 便透過 readyList.resolveWith 觸發回呼。
ready 另外處理了 holdReady。這個 API 的作用是延遲 ready 事件的回呼,主要目的是讓開發者在 ready 之前先做一些事。holdReady 會設定一個旗標 readyWait,當它被設定之後,ready 在呼叫 readyList.resolveWith 之前會不斷以 setTimeout(jQuery.ready, 1) 遞迴呼叫自己,每隔固定時間檢查一次,直到被 holdReady 釋放為止,setTimeout 才會沿著呼叫堆疊回來。每次 setTimeout 時會遞增 readyWait,用來記錄被 holdReady 延誤了幾次呼叫。
從 543 行開始定義了幾個值得留意的工具函式:parseJSON、parseXML 與 globalEval。
把字串轉為 JSON 物件。一般我們直接用 eval,parseJSON 封裝了這個操作,但把 eval 當作最後手段——因為新的 JavaScript 標準已內建 JSON 序列化與反序列化 API,若瀏覽器支援,這些 API 是以原生程式碼實作,效率遠高於 eval。當時 Chrome 與 Firefox 4 都已支援。
// 原生 JSON API。序列化是 JSON.stringify(object)
if(window.JSON && window.JSON.parse) {
return window.JSON.parse(data);
}
// ... 大致地檢查一下字符串合法性
return (new Function("return " + data))();
同樣是標準 API 與 IE 的封裝。標準做法用 DOMParser,IE 則用 Microsoft.XMLDOM 的 ActiveXObject:
if(window.DOMParser) {
tmp = new DOMParser();
xml = tmp.parseFromString(data, "text/xml");
} else {
xml = new ActiveXObject("Microsoft.XMLDOM");
xml.async = "false";
xml.loadXML(data);
}
把一段腳本在全域 context 中執行。IE 可用 window.execScript,其他瀏覽器則需借助 eval。因為整個 jQuery 原始碼都包在一個匿名函式裡,此時的 context 是 jQuery 而非 window,所以要特別繞一下:
(window.execScript || function(data) {
window["eval"].call(window, data); // 在 window context 下運行
})(data);