Ajax(Asynchronous JavaScript and XML)這個名詞,用來描述 JavaScript 的兩項強大能力。這兩項能力其實存在多年,卻長期被網路開發者忽略,直到 Gmail、Google Suggest 與 Google Maps 相繼出現,人們才真正意識到它們的價值。
這兩項被忽略的能力是:
要用 JavaScript 向伺服器發出 HTTP 請求,需要一個具備此能力的類別實例。這個類別最早由 Internet Explorer 以 ActiveX 物件形式引入,名為 XMLHTTP;隨後 Mozilla、Safari 等瀏覽器跟進,提供了 XMLHttpRequest 類別,支援微軟 ActiveX 物件所提供的同名方法與屬性。
因此,建立跨瀏覽器的實例可以這樣寫:
if (window.XMLHttpRequest) { // Mozilla, Safari, ...
http_request = new XMLHttpRequest();
} else if (window.ActiveXObject) { // IE
http_request = new ActiveXObject("Microsoft.XMLHTTP");
}
若伺服器的回應沒有 XML MIME 標頭,部分 Mozilla 系瀏覽器可能無法正常運作。解法是明確覆寫 MIME 型別:
http_request = new XMLHttpRequest();
http_request.overrideMimeType('text/xml');
接著要決定收到回應後要做什麼——也就是指定處理函式:
http_request.onreadystatechange = nameOfTheFunction;
注意函式名後不帶括號、也不傳參數。另一種寫法是直接塞入匿名函式:
http_request.onreadystatechange = function(){
// 處理回應
};
最後送出請求:
http_request.open('GET', 'https://www.example.org/some.file', true);
http_request.send(null);
三個參數各有含義:
若第一個參數是 POST,send() 的參數可以是任何要送交伺服器的資料,但必須是字串形式,格式為 name=value&anothername=othervalue&so=on。
先檢查 readyState。等於 4 表示完整的伺服器回應已收到,可以開始處理:
if (http_request.readyState == 4) {
// 一切就緒,可以處理回應
} else {
// 尚未完成
}
readyState 的五種取值:
接著檢查 HTTP 狀態碼,我們最關心的是 200 OK:
if (http_request.status == 200) {
// 完美!
} else {
// 請求有問題,例如 404 Not Found 或 500 Internal Server Error
}
兩個檢查都通過後,就能取出資料。有兩種方式:
http_request.responseText:以文字字串回傳伺服器的回應。http_request.responseXML:以 XMLDocument 物件回傳回應,可用 JavaScript 的 DOM 方法處理。現在把整個流程走一遍:用 JavaScript 請求同目錄下的 test.html(內容為 "I'm a test."),再用 alert() 把內容跳出來。
<script type="text/javascript">
var http_request = false;
function makeRequest(url) {
if (window.XMLHttpRequest) {
http_request = new XMLHttpRequest();
} else if (window.ActiveXObject) {
try {
http_request = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) {}
}
if (!http_request) {
alert("無法建立 XMLHttpRequest 物件。");
return false;
}
http_request.onreadystatechange = alertContents;
http_request.open('GET', url, true);
http_request.send(null);
}
function alertContents() {
if (http_request.readyState == 4) {
if (http_request.status == 200) {
alert(http_request.responseText);
} else {
alert("請求發生問題,狀態碼:" + http_request.status);
}
}
}
</script>
<a href="#" onclick="makeRequest('test.html'); return false;">
Make a request
</a>
流程是:使用者點擊「請求」連結 → 呼叫 makeRequest(),參數 test.html 位於同一目錄 → 送出請求,onreadystatechange 指向 alertContents() → 收到成功回應後,alert() 跳出 test.html 的內容。
前面的例子用的是 responseText。現在改用 responseXML。先準備一份合法的 XML 檔 test.xml:
<?xml version="1.0" ?>
<root>I'm a test.</root>
請求部分的寫法不變,只要把 URL 換成 test.xml;真正需要修改的是 alertContents():
function alertContents() {
if (http_request.readyState == 4) {
if (http_request.status == 200) {
var xmldoc = http_request.responseXML;
var root_node = xmldoc.getElementsByTagName('root').item(0);
alert(root_node.firstChild.data);
}
}
}
差別在於:responseText 給你一整段文字,而 responseXML 給你一個文件物件模型,可以用 getElementsByTagName() 定位節點、走 firstChild 取得文字節點、再用 .data 取出實際內容。當回應是結構化資料(例如多筆記錄的清單)時,這種做法比字串切割可靠得多。
把這四個步驟串起來,你就掌握了 Ajax 的完整骨架:建立跨瀏覽器物件、設定 onreadystatechange、以 open/send 送出請求、在 callback 中檢查 readyState 與 status,最後依需求選擇 responseText 或 responseXML。接下來要練的,是錯誤處理、逾時控制,以及把重複的請求邏輯抽成可重複使用的工具函式。