多數 Web 應用程式都採用「請求/回應」模型取得整份 HTML:點一下按鈕、等伺服器、再點下一個按鈕、再等。有了 Ajax 與 XMLHttpRequest 物件,就能用一種不必讓使用者乾等的請求/回應模型。本文由 Brett McLaughlin 的經典連載改寫而成,聚焦最基礎也最關鍵的這個物件。
聽到 Web 2.0 時,不妨先問一句:那 Web 1.0 是什麼?雖然少有人提,它指的就是傳統那套完全不同的請求與回應模型。比如在 Amazon 點個按鈕或輸入關鍵字搜尋,請求送到伺服器,回應是另一份完整的 HTML 頁面,瀏覽器重新繪製時難免出現閃爍與抖動。你看到的每一個新頁面,就是一次清清楚楚的請求與回應。
Web 2.0 在很大程度上消除了這種看得見的往返。以 Google Maps 或 Flickr 為例,你可以拖曳地圖、放大縮小,幾乎感覺不到重繪。請求與回應依然存在,只是被藏到幕後;使用者獲得的體驗更接近桌面應用程式。
關鍵在於:讓請求與回應只承載真正需要的資料,而不是整份 HTML。只有在使用者確實要換頁時,才值得取回整個新頁面。絕大多數互動其實只是在既有頁面上補充細節、修改文字或覆蓋既有內容——這些情況正適合用 Ajax 處理。
這個小物件其實已在瀏覽器中存在一段時間,卻是 Web 2.0 與 Ajax 的核心。先掌握幾個關鍵成員:
open():建立到伺服器的新請求。send():向伺服器送出請求。abort():中止當前請求。readyState:提供當前請求的就緒狀態。responseText:伺服器回傳的回應文字。把這些成員放在一起看會發現,它們全都繞著同一件小事打轉:送出請求、接收回應。不會有什麼神秘的 GUI 物件,也不會有全新的互動模型。聽起來不特別吸引人,但用好這個物件足以徹底改變你的應用程式。
<script language="Javascript" type="text/Javascript"> var request = new XMLHttpRequest(); </script>
JavaScript 不必宣告變數型別,所以不需要像 Java 那樣寫 XMLHttpRequest request = new XMLHttpRequest();,用 var 宣告、命名、賦值即可。
現實中什麼都可能出錯,而上面那段程式沒有任何保護。較穩妥的寫法是:建立物件,出問題時優雅退出,並告知使用者。
<script language="Javascript" type="text/Javascript">
var request = false;
try {
request = new XMLHttpRequest();
} catch (failed) {
request = false;
}
if (!request)
alert("Error initializing XMLHttpRequest!");
</script>
逐步拆解:
request 並設為 false,稍後用它當作判定條件——false 代表物件尚未建立成功。try/catch 嘗試建立;失敗時確保 request 仍是 false。request 是否仍為 false。程式碼很短,但多數人「讀懂」它花的時間比「寫出」它更長。
看起來一切良好——直到你在 Internet Explorer 上試跑。

顯然哪裡不對勁。而 IE 當時佔有全球約七成市場,不支援它等於放棄整個 Web 世界。查證之後會發現:微軟同樣支援 Ajax,只是它的 XMLHttpRequest 有著不同名字——新版本使用 Msxml2.XMLHTTP,舊版本則是 Microsoft.XMLHTTP。要同時兼容兩者與非微軟瀏覽器,就得逐層嘗試:
<script language="Javascript" type="text/Javascript">
var request = false;
try {
request = new XMLHttpRequest();
} catch (trymicrosoft) {
try {
request = new ActiveXObject("Msxml2.XMLHTTP");
} catch (othermicrosoft) {
try {
request = new ActiveXObject("Microsoft.XMLHTTP");
} catch (failed) {
request = false;
}
}
}
if (!request)
alert("Error initializing XMLHttpRequest!");
</script>
步驟如下:先宣告 request = false;嘗試標準寫法;失敗則嘗試新版 IE 的 ActiveX 物件;再失敗則嘗試舊版 IE 的物件;全部失敗才把 request 留在 false;最後檢查並提示錯誤。
改好之後再用 IE 試一次,這回應該正常顯示表單而不再跳錯誤。

值得一提的是,IE 7 之後開始直接支援 XMLHttpRequest,可以回歸標準寫法。但基於舊版瀏覽器仍在使用,跨瀏覽器程式碼短期內不會消失。
上述程式碼都直接寫在 <script> 標記中,這種不放在函式內的 JavaScript 稱為靜態 JavaScript——它在頁面呈現給使用者之前就已執行。多數 Ajax 開發者都用這種方式建立 XMLHttpRequest。
另一種寫法是把建立邏輯收進函式:
var request;
function createRequest(){
try {
request = new XMLHttpRequest();
} catch (trymicrosoft) {
try {
request = new ActiveXObject("Msxml2.XMLHTTP");
} catch (othermicrosoft) {
try {
request = new ActiveXObject("Microsoft.XMLHTTP");
} catch (failed) {
request = false;
}
}
}
if (!request)
alert("Error initializing XMLHttpRequest!");
}
function getCustomerInfo(){
createRequest();
// 後續使用 request 進行作業
}
這種寫法唯一的缺點是把錯誤通知延後了,這也是多數人不採用它的原因。想像一份有十幾個欄位的表單,使用者在填到第十四個欄位時才觸發 Ajax,這時才發現瀏覽器不支援——徒勞無功的十分鐘,換來一次令人惱火的警告,使用者大概不會再回來。
若改用靜態程式碼,使用者在點進頁面的瞬间就會看到錯誤。這同樣令人不悅,甚至可能讓他以為你的網站壞了;但總比浪費他十分鐘之後才告知要好。結論:把環境檢查寫成靜態程式碼,讓問題盡早暴露。
Ajax 採用沙箱安全模型,因此 XMLHttpRequest 只能對同一個網域送出請求。在本機執行的程式只能呼叫本機的伺服器端腳本,跨網域必須另尋他法。
接著組出要連的 URL。多數應用會把靜態路徑與表單資料結合起來:
function getCustomerInfo(){
var phone = document.getElementById("phone").value;
var url = "/CGI-local/lookupCustomer.php?phone=" + escape(phone);
}
對應的表單如下:
<body>
<p><img src="breakneck-logo_4c.gif" alt="Break Neck Pizza" /></p>
<form action="POST">
<p>Enter your phone number:
<input type="text" size="14" name="phone" id="phone"
onChange="getCustomerInfo();" />
</p>
<p>Your order will be delivered to:</p>
<div id="address"></div>
<p>Type your order in here:</p>
<p><textarea name="order" rows="6" cols="50" id="order"></textarea></p>
<p><input type="submit" value="Order Pizza" id="submit" /></p>
</form>
</body>
當使用者輸入或修改電話號碼,就會觸發 getCustomerInfo(),取出號碼並組出 URL。由於是沙箱環境,URL 中不需要網域名稱;電話號碼以 GET 參數附加在腳本名後:"phone=" + escape(phone)。
escape() 負責轉義無法以純文字安全傳輸的字元,例如空格會被換成 %20。若需要更多參數,用 & 串接即可(第一個參數以 ? 與腳本名分隔)。
open() 共有五個參數:
true。實務上通常只用前三個參數。即使你要非同步,也建議明確把第三個參數寫成 true——雖然那是預設值,但把意圖寫在程式碼裡永遠更好讀。
function getCustomerInfo(){
var phone = document.getElementById("phone").value;
var url = "/CGI-local/lookupCustomer.php?phone=" + escape(phone);
request.open("GET", url, true);
}
順帶一提,open() 這個命名其實頗有爭議:它並不會真的「開啟」一個連線。如果監看網路傳輸,呼叫 open() 時不會看到任何通訊發生。
在傳統的同步模型中,客戶端發出請求後必須等待回應。等待期間,使用者會看到某種形式的暗示:Windows 上的沙漏、Mac 上的旋轉球,或者應用程式直接凍結一段時間。
這正是傳統 Web 應用讓人覺得遲鈍的原因——缺乏真正的互動性。按下按鈕之後,應用程式實際上處於不可用狀態,直到請求回來。若伺服器需要大量運算,等待時間可能相當可觀。
非同步請求則不等待回應:送出請求後,應用程式立刻繼續運行。使用者可以繼續在表單中輸入,甚至離開該欄位;沒有旋轉球、沒有凍結。伺服器在背景安靜地處理,完成後再通知原本的呼叫者。結果是應用感覺迅速、回應及時——這只是 Web 2.0 的一小部分,卻是極關鍵的一部分。所有華麗的 GUI 元件都無法彌補同步模型帶來的遲鈍。
send() 只有一個參數,即要送出的內容。前面已經把資料放進 URL,因此若不需要額外傳輸內容,傳 null 即可:
function getCustomerInfo(){
var phone = document.getElementById("phone").value;
var url = "/CGI-local/lookupCustomer.php?phone=" + escape(phone);
request.open("GET", url, true);
request.send(null);
}
在典型 Ajax 應用中,約八成請求用 GET 就足夠;若需傳送敏感資訊或 XML,才考慮改用 send() 攜帶內容。
如果只寫到上一段,程式有一個明顯破洞:因為是非同步,getCustomerInfo() 不會等伺服器,執行緒直接往下跑並把控制權交還表單。那麼伺服器處理完之後呢?什麼也不會發生。
Ajax 最大的祕密就在 XMLHttpRequest 的一個簡單屬性:onreadystatechange。由於 JavaScript 是弱型別語言,函式名稱本身就是一個可指涉的變數,因此可以直接把函式名稱指派給它:
function getCustomerInfo(){
var phone = document.getElementById("phone").value;
var url = "/CGI-local/lookupCustomer.php?phone=" + escape(phone);
request.open("GET", url, true);
request.onreadystatechange = updatePage; // 必須在 send() 之前設定
request.send(null);
}
位置很關鍵:一定要在呼叫 send() 之前設定,這樣伺服器回應完成後才有函式可查。
先寫個最簡單的回呼:
function updatePage(){
alert("Server is done!");
}
實際跑起來你會發現,依瀏覽器不同,警告可能跳出兩次、三次甚至四次。

原因是我們還沒檢查 HTTP 就緒狀態。事實上,onreadystatechange 會在每一次就緒狀態改變時被呼叫,而不只是完成時。就緒狀態共有五種:
open() 之前)。send() 之前)。與多數跨瀏覽器議題一樣,這些狀態的呈現並不一致:有的瀏覽器從不回報 0 或 1,直接從 2 開始;有的回報全部;有的則會重複回報狀態 1。這正是警告彈出多次的原因。
對 Ajax 開發而言,唯一需要處理的狀態就是 4:
function updatePage(){
if (request.readyState == 4)
alert("Server is done!");
}
還有一個問題:如果伺服器完成了處理,卻回報錯誤呢?伺服器端程式並不知道呼叫者是 Ajax、JSP 還是普通表單,它只能沿用傳統的 Web 方式來傳達結果——也就是 HTTP 狀態碼。
你一定遇過輸入錯誤網址而得到 404 的情形;403 與 401 分别表示禁止存取與需要授權,也很常見。這些錯誤碼都是在一個已完成的回應中傳回的:伺服器確實履行了請求(就緒狀態是 4),但沒有給出客戶端期望的資料。
因此除了就緒狀態,還必須檢查狀態碼。我們期待的是 200:
function updatePage(){
if (request.readyState == 4)
if (request.status == 200)
alert("Server is done!");
}
加上一點錯誤處理會更穩健:
function updatePage(){
if (request.readyState == 4){
if (request.status == 200)
alert("Server is done!");
else if (request.status == 404)
alert("Request URL does not exist");
else
alert("Error: status code is " + request.status);
}
}
把 URL 故意改成不存在的位址試試,你會看到對應的提示。很難窮舉所有錯誤條件,但這一小段就能涵蓋典型 Web 應用約八成的問題。
現在具備兩個前提:請求已完成(就緒狀態)、伺服器回應正常(狀態碼)。回應內容存放在 responseText 屬性中。
關於 responseText 的格式與長度,規格刻意保持開放——伺服器可以回傳任何內容。有的腳本回傳逗號分隔值,有的用管線符號(|)分隔,有的直接回傳長文字。決定權在伺服器手上。
本例中,伺服器回傳客戶的上次訂單與地址,以管線符號分隔:
function updatePage(){
if (request.readyState == 4){
if (request.status == 200){
var response = request.responseText.split("|");
document.getElementById("order").value = response[0];
document.getElementById("address").innerHTML =
response[1].replace(/\n/g, "<br />");
} else
alert("status is " + request.status);
}
}
先用 split() 以管線符號切開,得到陣列 response。第一個值(上次訂單)以 response[0] 取出,指派給 ID 為 order 的欄位;第二個值(地址)需要多一步處理——地址中的換行是 \n,需以正則表達式配合 replace() 換成 XHTML 風格的 <br />,最後寫入 div 元素的 innerHTML。
結果是表單瞬間被客戶資料填滿,畫面完全沒有重載。

XMLHttpRequest 另有一個重要屬性 responseXML:若伺服器選擇以 XML 回應,該屬性會包含解析後的 XML 文件。處理 XML 與處理純文字差異不小,涉及解析、DOM 與相關 API。對許多簡單的 Ajax 應用而言 responseText 就夠用,但很快就會發現 Ajax 同樣能優雅地處理 XML。
一整篇文章只談一個物件,看起來不成比例——尤其這物件還如此簡單。但你在每一個用 Ajax 寫成的頁面與應用中都會反覆使用它。後續可延伸的主題還很多:POST 與 GET 的實際差異、設定與讀取內容標頭、請求的編碼方式,以及如何使用 responseXML。
常見的 Ajax 工具庫其實把本文這些細節都藏了起來,讓開發更輕鬆。有人因此疑惑:既然有工具庫,何必理解底層?答案很實際——若不了解應用程式實際在做什麼,出問題時你就無從下手。不要只是掃過這些細節;哪天方便華麗的工具庫出錯,你不必抓頭,也不必發信求助。只要知道如何直接操作 XMLHttpRequest,最古怪的問題都能自己查到答案。
只有真正替你解決問題的工具,才是好工具。所以,去熟悉 XMLHttpRequest 吧——如果你手上已有用了工具庫的 Ajax 程式碼,不妨試著用原生物件與屬性重寫一遍,這是理解原理最有效的方式。