AJAX 讓網頁能在不重新載入整頁的情況下與伺服器交換資料,是現代 Web 應用互動性的基礎。本文從建立 XMLHttpRequest 物件的相容寫法開始,走過一次完整的請求生命週期。
標準瀏覽器直接有 window.XMLHttpRequest,舊版 IE 則要透過 ActiveX 建立,且不同 IE 版本對應不同的 ProgID。
var xhr = null;
if (window.XMLHttpRequest) {
// 標準瀏覽器
xhr = window.XMLHttpRequest;
} else if (window.ActiveXObject) {
// 舊版 IE
try {
// 高版本,受 msxml3.dll 支援
xhr = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
try {
// 低版本,msxml 2.6 以下
xhr = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) {
alert("瀏覽器無法建立 XMLHttpRequest 物件!");
}
}
}
在今天的環境中這段程式碼可以簡化成 var xhr = new XMLHttpRequest();。保留它主要是為了理解歷史脈絡,以及維護老系統時的參考。
// 1. 設定請求:方法、網址、是否非同步
xhr.open("POST", url, true);
// 2. 以表單格式送出時,需明確指定 Content-Type
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
// 3. 綁定狀態變化處理器
xhr.onreadystatechange = stateChangeHandler;
// 4. 送出主體(GET 請求傳 null)
xhr.send();
// 若要帶參數:xhr.send("name=clf");
function stateChangeHandler() {
// readyState 4 = 請求完成;status 200 = 成功
if (xhr.readyState == 4 && xhr.status == 200) {
var obj = document.getElementById("targetDiv");
obj.innerHTML = xhr.responseText;
}
}
理解這個值是除錯的關鍵:
| 值 | 狀態 | 說明 |
|---|---|---|
| 0 | UNSENT | 尚未呼叫 open() |
| 1 | OPENED | open() 已呼叫,尚未 send() |
| 2 | HEADERS_RECEIVED | send() 已呼叫,回應標頭已抵達 |
| 3 | LOADING | 正在接收回應本文 |
| 4 | DONE | 資料傳輸完成 |
注意 readyState 的拼字——全小寫的 s。原範例中寫成 xhr.readystate 雖然在 JS 中不會報錯,但因為屬性名區分大小寫,這個判斷永遠為 false,回呼函式會安靜地什麼都不做。這是 this 類拼寫錯誤特別難查的原因。
responseText:回應本文,永遠是字串。
responseXML:若回應的 Content-Type 是 XML,瀏覽器會自動解析成文件物件,可直接用 DOM 方法查詢。
response:可搭配 responseType 取得 "json"、"blob"、"arraybuffer" 等型別的資料。
只判斷 status == 200 是不夠的。伺服器可能回傳 404、500,網路也可能直接中斷:
xhr.onreadystatechange = function () {
if (xhr.readyState !== 4) { return; }
if (xhr.status === 200) {
document.getElementById("targetDiv").innerHTML = xhr.responseText;
} else {
console.error("請求失敗:", xhr.status, xhr.statusText);
}
};
// 網路層級的錯誤(請求根本沒送達)
xhr.onerror = function () {
console.error("網路錯誤");
};
原生 XMLHttpRequest 的 API 設計以回呼為中心,巢狀一多就很難讀。ES2015 之後的 fetch 回傳 Promise,語意清楚得多:
fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
body: 'name=clf'
})
.then(function (response) {
if (!response.ok) {
throw new Error('HTTP ' + response.status);
}
return response.text();
})
.then(function (text) {
document.getElementById("targetDiv").innerHTML = text;
})
.catch(function (err) {
console.error(err);
});
若環境支援 async/await,可以寫得更接近同步程式碼的可讀性:
async function loadContent() {
try {
var response = await fetch(url);
if (!response.ok) { throw new Error('HTTP ' + response.status); }
var data = await response.json();
render(data);
} catch (err) {
console.error(err);
}
}
要留意 fetch 有兩個容易踩的點:一是它不會在 HTTP 錯誤狀態(4xx、5xx)時 reject,必須自己檢查 response.ok;二是它預設不帶 cookie,需要跨來源請求時得明確加上 credentials: 'include'。
請求應加上逾時控制,避免使用者面對無限期的等待旋轉:xhr.timeout = 10000; 搭配 xhr.ontimeout,或用 AbortController 取消 fetch。此外,把使用者輸入直接塞進 innerHTML 會造成 XSS 風險,若內容可能含有標籤,應改用 textContent 或先做適當的轉義處理。