今天看了 XMLHttpRequest 的屬性,整理如下。
onreadystatechange
狀態改變時都會觸發這個事件,通常會在裡頭呼叫一支 JavaScript 函式。readyState 有五個值:
responseText
伺服器的回應,以字串形式呈現。
responseXML
伺服器的回應,以 XML 文件形式呈現。
status
伺服器回傳的 HTTP 狀態碼:200 對應 OK,404 對應找不到資源,還有很多其他值。
statusText
伺服器回傳的 HTTP 狀態文字,例如 OK、Not Found。
這幾個屬性裡,最容易被初學者忽略的是 status。很多人只檢查 readyState == 4 就開始讀 responseText,結果在請求失敗(例如 500 或 404)時拿到一頁錯誤訊息,卻當成正常資料處理。正確的寫法是兩個條件都要看。
目標很單純:使用者在輸入框填完電子郵件、離開該欄位時,由用戶端觸發一次 Ajax 事件,請伺服器協助驗證格式。
<input type="text" id="email" name="email" onblur="validateemail();" />
對應的 validateemail() 函式:
var xmlHttp;
function validateemail() {
var email = document.getElementById("email");
var url = "validate?email=" + escape(email.value);
if (window.ActiveXObject) {
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
} else if (window.XMLHttpRequest) {
xmlHttp = new XMLHttpRequest();
}
xmlHttp.open("GET", url);
xmlHttp.onreadystatechange = callback;
xmlHttp.send(null);
}
/* ---------------------------------------------------------------
* Function Name : callback
* Input Arguments : 無
* Out Arguments : 無
* --------------------------------------------------------------- */
function callback() {
if (xmlHttp.readyState == 4) {
if (xmlHttp.status == 200) {
// 伺服器回覆驗證結果,在這裡處理
var result = xmlHttp.responseText;
// ... 依 result 更新畫面提示
} else {
alert("請求失敗,狀態碼:" + xmlHttp.status);
}
}
}
onreadystatechange 要在 send() 之前指定,否則回應太快送達時回呼不會被觸發。escape() 對非 ASCII 字元使用的是 %uXXXX 格式,伺服器端不一定解得出來。建議改用 encodeURIComponent(),並確認後端以 UTF-8 解碼。&t= 加上時間戳),要嘛由伺服器端送出 no-cache 標頭。xmlHttp 宣告在全域,同一頁面上若有兩個並行的 Ajax 請求,就會互相覆蓋。實務上應該改用閉包或宣告在函式內。把這些屬性與流程記熟之後,Ajax 其餘的變化多半只是換個資料格式、換個更新目標而已。真正的骨架,從頭到尾就是「建立物件、開啟連線、指定回呼、送出、檢查狀態、處理回應」這六步。