近來開始研究 AJAX(Asynchronous JavaScript and XML),很幸運地找到了發表於 Devmo 上的經典入門文章《AJax: Getting Started》。以下將這篇淺顯易懂的內容整理轉述,希望能幫助同樣剛入門的朋友快速上手。
AJAX 是一個新的合成術語,背後其實隱含了兩個已存在多年的 JavaScript 特性;直到 Gmail、Google Suggest 與 Google Maps 等應用造成轟動,才廣受網路開發者矚目。這兩個特性讓你能夠:向伺服器發出請求而無需重新載入頁面,以及解析 XML 文件並與之協同工作。
這個縮寫中,A 代表 asynchronous(非同步),意指發出請求後可以一邊做其他事、一邊等待回應;JA 代表 JavaScript;X 代表 XML(可擴展標記語言)。
要用 JavaScript 向伺服器發出請求,需要一個類別的實例。這個類別最早在 IE 中以 ActiveX 物件 XMLHTTP 的形式提出,之後 Mozilla、Safari 等瀏覽器相繼跟進,提供了 XMLHttpRequest 類別。為了跨瀏覽器建立物件,可以這樣寫:
if (window.XMLHttpRequest) { // Mozilla, Safari, ...
http_request = new XMLHttpRequest();
} else if (window.ActiveXObject) { // IE
http_request = new ActiveXObject("Microsoft.XMLHTTP");
}
部分 Mozilla 版本若遇到未含 XML mime-type 標頭的回應可能無法處理,為保險起見可用 overrideMimeType 強制指定:
http_request = new XMLHttpRequest();
http_request.overrideMimeType('text/XML');
接著決定收到回應後要做什麼,只要把處理函式指派給 onreadystatechange 屬性即可(注意函式名稱後不加括號):
http_request.onreadystatechange = nameOfTheFunction;
最後呼叫 open 與 send 發出請求:
http_request.open('GET', 'https://www.example.org/some.file', true);
http_request.send(null);
open() 第一個參數是請求方式(GET、POST、HEAD 等),名稱需大寫;第二個參數是請求的 URL;第三個參數設定是否非同步,為 TRUE 時 JavaScript 會繼續執行而不等待回應,這正是 AJAX 裡「A」的意義。send() 的參數是欲傳送給伺服器的資料,格式為查詢字串:name=value&anothername=othervalue&so=on。回呼函式首先要檢查 readyState。當值為 4,代表伺服器回應已全部接收完畢:
if (http_request.readyState == 4) {
// 一切就緒,回應已接收完成
} else {
// 尚未就緒
}
readyState 的所有值:0(未初始化)、1(載入中)、2(載入完畢)、3(互動中)、4(完成)。接著檢查 HTTP 狀態碼,我們通常只關心 200 OK:
if (http_request.status == 200) {
// 一切正常!
} else {
// 可能出現 404(找不到)或 500(伺服器內部錯誤)
}
資料有兩種取用方式:responseText 把回應當字串處理,responseXML 則把回應當 XMLDocument 物件,可用 DOM 函式操作。
下面的腳本會請求一個名為 test.Html 的文件,並用 alert 顯示其內容:
<script type="text/Javascript" language="Javascript">
var http_request = false;
function makeRequest(url) {
http_request = false;
if (window.XMLHttpRequest) { // Mozilla, Safari,...
http_request = new XMLHttpRequest();
if (http_request.overrideMimeType) {
http_request.overrideMimeType('text/XML');
}
} else if (window.ActiveXObject) { // IE
try {
http_request = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
try {
http_request = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) {}
}
}
if (!http_request) {
alert('Giving up :( Cannot create an XMLHTTP instance');
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('There was a problem with the request.');
}
}
}
</script>
<span style="cursor: pointer; text-decoration: underline">
發出請求
</span>
流程為:使用者點擊「發出請求」→ 呼叫 makeRequest('test.Html') → 請求送出並把 onreadystatechange 交給 alertContents → 後者確認回應完成且狀態為 OK,便 alert 出檔案內容。
先建立一份有效的 XML 文件(test.XML):
<?XML version="1.0" encoding="utf-8" ?> <root> 這是個測試. </root>
在 alertContents 中改用 responseXML,並以 DOM 方法取出節點內容:
var xmldoc = http_request.responseXML;
var root_node = xmldoc.getElementsByTagName('root').item(0);
alert(root_node.firstChild.data);
如此一來,就能取得 responseXML 中的 XMLDocument 物件,並用 DOM 方法存取文件內容。想深入了解更多 DOM 方法,可參考 Mozilla 的 DOM 實作文件。