jQuery 的 ajax 模組有八百多行,光是核心函式 jQuery.ajax 就接近四百行,直接硬讀很容易被細節邏輯淹沒。
比較聰明的路徑是先看一段精簡的實作。本文選用早期百度七巧板專案中的 ajax.request——它把 AJAX 該做的事全都做了,卻沒有多餘的抽象層,正好用來複習基本功。
/**
* 發送一個 ajax 請求
* @grammar ajax.request(url[, options])
* @param {string} url 請求的 url
* @param {Object} options 選項參數
* @config {String} [method] 請求類型,預設 GET
* @config {Boolean} [async] 是否非同步,預設 true
* @config {String} [data] 要傳送的資料
* @config {Object} [headers] 要設定的 request header
* @config {number} [timeout] 逾時時間(ms)
* @config {String} [username] 使用者名稱
* @config {String} [password] 密碼
* @config {Function} [onsuccess] 成功回呼 function(xhr, responseText)
* @config {Function} [onfailure] 失敗回呼 function(xhr)
* @config {Function} [onbeforerequest] 送出前回呼 function(xhr)
* @returns {XMLHttpRequest}
*/
var ajax = {};
ajax.request = function(url, options, type){
var async = options.async || true,
username = options.username || "",
password = options.password || "",
data = options.data || "",
method = (options.method || "GET").toUpperCase(),
headers = options.headers || {},
eventHandler = {},
dataType = type || "string"; // xml || string
function stateChangeHandler(){
if (xhr.readyState == 4){
var sta = xhr.status;
if (sta == 200 || sta == 304) fire("success");
else fire("failure");
// 解除綁定,釋放引用(非同步時尤其重要,避免記憶體無法回收)
window.setTimeout(function(){
xhr.onreadystatechange = new Function();
if (async) xhr = null;
}, 0);
}
}
function fire(type){
type = "on" + type;
var handler = eventHandler[type];
if (handler){
if (type != "onsuccess") handler(xhr);
else handler(xhr, dataType != "xml" ? xhr.responseText : xhr.responseXML);
}
}
// 把 options 中的回呼收集到 eventHandler
for (var key in options) eventHandler[key] = options[key];
var xhr = new XMLHttpRequest();
// GET:把資料拼進 query string
if (method == "GET"){
url += (url.indexOf("?") >= 0) ? "&" : "?";
url += data;
data = null;
}
if (async) xhr.onreadystatechange = stateChangeHandler;
if (username) xhr.open(method, url, async, username, password);
else xhr.open(method, url, async);
if (method == "POST")
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
for (var key in headers) xhr.setRequestHeader(key, headers[key]);
fire("beforerequest");
xhr.send(data);
if (!async) stateChangeHandler(); // 同步請求需手動觸發一次
return xhr;
}
流程非常清楚:以 XMLHttpRequest() 建立物件;判斷 GET 或 POST,GET 就組裝 URL、POST 就設定請求標頭;若是非同步則註冊 stateChangeHandler 監聽;視需要帶上使用者名稱密碼後呼叫 open;送出請求;最後交由監聽函式處理回應。
值得注意的兩個細節:一是 readyState == 4 代表請求完成,而 status 為 200 或 304 都算成功(304 是命中快取);二是完成後主動把 onreadystatechange 換成空函式並在必要時將 xhr 設為 null,這是避免舊版 IE 因循環參考而無法回收記憶體的經典手法。
兩者都只是對 ajax.request 的薄封裝:
ajax.post = function(url, data, onsuccess){
return ajax.request(url, { "data": data, "onsuccess": onsuccess, method: "POST" });
};
ajax.get = function(url, data, onsuccess){
return ajax.request(url, { "data": data, "onsuccess": onsuccess });
};
這種「一個核心函式 + 多個語法糖」的結構,正是 jQuery 的 $.ajax / $.get / $.post / $.getJSON 所採用的同一套設計。讀懂這三百行的簡化版之後,回頭再看 jQuery 原始碼中多出的 dataType 推斷、跨域 JSONP、逾時處理與 deferred 物件,就能清楚辨識每一塊各自的職責了。