如果暫時忘掉 $.ajax 的琳瑯滿目參數,Ajax 的本質其實只是「建立 XHR、註冊回呼、送出請求」。本篇先還原裸寫的樣子,再看 jQuery 如何把它優雅地包起來。
// 建立 XHR 物件,需兼顧 IE 的 ActiveX 分支
var xhr;
if (window.XMLHttpRequest) {
xhr = new XMLHttpRequest();
} else if (window.ActiveXObject) {
xhr = new ActiveXObject("Msxml2.XMLHTTP");
} else {
throw new Error("Ajax is not supported by this browser");
}
function ready() {
alert("Start......");
// 以事件回呼處理異步結果
xhr.onreadystatechange = function () {
if (xhr.readyState == 4) {
alert("Ready.");
if (xhr.status == 200) {
alert("成功獲得服務器返回的結果.");
alert(xhr.responseText);
// 把回傳的 JSON 字串轉為物件
var alice = eval("(" + xhr.responseText + ")");
alert(alice.name);
}
}
};
xhr.open("get", "data.json");
xhr.send(null);
}
幾行代碼裡就有三個坑:瀏覽器差異、狀態判斷、字串轉物件。jQuery 的價值就是替我們把這些瑣事收攏。
做法很直白:把常用設定集中成一份預設值,再對外提供「改預設」與「發請求」兩個入口。
jQuery.extend({
// 請求的預設參數
ajaxSettings: {
url: location.href,
type: "GET",
contentType: "application/x-www-form-urlencoded",
data: null,
xhr: window.XMLHttpRequest &&
(window.location.protocol !== "file:" || !window.ActiveXObject)
? function () { return new window.XMLHttpRequest(); }
: function () {
try { return new window.ActiveXObject("Microsoft.XMLHTTP"); }
catch (e) { }
}
},
// 供全域調整預設值
ajaxSetup: function (settings) {
jQuery.extend(jQuery.ajaxSettings, settings);
},
ajax: function (origSettings) {
// 深拷貝合併:預設值 + 本次傳入
var s = jQuery.extend(true, {}, jQuery.ajaxSettings, origSettings);
// 建立 xhr
var xhr = s.xhr();
// 回呼
xhr.onreadystatechange = function (isTimeout) {
if (xhr.readyState === 4) {
if (xhr.status == 200) {
s.success.call(origSettings, xhr.responseText);
}
}
};
xhr.open(s.type, s.url);
xhr.send(s.data);
// 回傳 xhr,方便外部 abort
return xhr;
},
// get 的語法糖:省略 data 時自動位移參數
get: function (url, data, callback, type) {
if (jQuery.isFunction(data)) {
type = type || callback;
callback = data;
data = null;
}
return jQuery.ajax({
type: "GET",
url: url,
data: data,
success: callback,
dataType: type
});
}
});
有了 get,做一個「把回應塞進元素」的便捷方法就非常容易:
jQuery.fn.extend({
load: function (url) {
var self = this;
jQuery.get(url, function (data) {
self.each(function () {
this.innerHTML = data;
});
});
}
});
<input type="button" id="btn" value="Click me" />
<div id="msg"></div>
<script src="jQuery-core.js" type="text/javascript"></script>
<script src="jQuery-event-2.js" type="text/javascript"></script>
<script src="jQuery-data.js" type="text/javascript"></script>
<script src="jQuery-extend.js" type="text/javascript"></script>
<script src="jQuery-ajax.js" type="text/javascript"></script>
<script type="text/javascript">
$("#btn").click(function () {
$("#msg").load("hello.txt");
});
</script>
從裸 XHR 到 $("#msg").load("hello.txt"),中間三層封裝各司其職:ajax 負責請求、extend 負責參數合併、fn.extend 負責語法糖。這正是 jQuery 模組化擴展能力的縮影。