使用 Ajax 時經常遇到一個尷尬狀況:使用者在短時間內連續觸發多個非同步請求,而瀏覽器对同一個 XHR 的處理方式是——新請求一出現,舊請求就被取消。多數情況下這沒問題(例如重新查詢列表時,舊結果本來就不需要了),但如果這些請求彼此獨立、每一筆結果都必須完成,資料就會憑空消失。
瀏覽器對同時可執行的連線數也有限制(早期 IE 只允許兩個),一旦超過,較舊的請求同樣會被捨棄。解法並不複雜:把請求記錄下來,排隊依序執行。
建立一個陣列作為佇列,每個元素本身就是一組請求參數。使用者觸發請求時,不直接送出,而是先把參數打包進佇列;若佇列中只有這一筆,立刻執行;若已有其他項目,則什麼都不做——因為那代表佇列正在運作中,等前面的跑完自然會轮到它。每完成一筆就移出佇列頭端,再檢查是否還有剩餘項目,直到全部跑完為止。
// ---- Ajax 核心 ----
var reqObj; // 目前的請求物件
var RequestArray = []; // 請求佇列
/**
* 把一筆請求加入佇列
* @param {string} url 請求位址
* @param {boolean} isAsy 是否非同步
* @param {string} method get 或 post
* @param {string} parStr 要傳送的參數
* @param {string} callBackFun 完成後要呼叫的函式名稱
*/
function AddRequestArray(url, isAsy, method, parStr, callBackFun) {
var ArgItem = [url, isAsy, method, parStr, callBackFun];
RequestArray.push(ArgItem); // 排到佇列末尾
// 佇列中只有當前這一筆時才立即執行;
// 若还有其他項目,代表佇列仍在運作,稍後自然會轮到它
if (RequestArray.length === 1) {
ExeRequestArray();
}
}
// 執行佇列中排在第一位的那筆請求
function ExeRequestArray() {
if (RequestArray.length > 0) {
var ArgItem = RequestArray[0];
DoRequest(ArgItem[0], ArgItem[1], ArgItem[2], ArgItem[3], ArgItem[4]);
}
}
// 真正送出請求
function DoRequest(url, isAsy, method, parStr, callBackFun) {
reqObj = false;
if (window.XMLHttpRequest) {
reqObj = new XMLHttpRequest();
if (reqObj.overrideMimeType) {
reqObj.overrideMimeType('text/xml');
}
} else if (window.ActiveXObject) {
try {
reqObj = new ActiveXObject("Msxml2.XMLHTTP");
} catch (e) {
try {
reqObj = new ActiveXObject("Microsoft.XMLHTTP");
} catch (e) { }
}
}
if (!reqObj) {
alert('無法建立 XMLHTTP 物件,請更換瀏覽器。');
return false;
}
reqObj.onreadystatechange = function () { GetRequest(callBackFun); };
reqObj.open(method, url, isAsy);
reqObj.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
reqObj.send(parStr);
}
// 接收回應
function GetRequest(callBackFun) {
if (reqObj.readyState === 4) {
if (reqObj.status === 200) {
// 以函式名稱字串呼叫回呼
if (typeof window[callBackFun] === 'function') {
window[callBackFun](reqObj);
}
} else {
alert('請求發生問題,狀態碼:' + reqObj.status + ',回呼:' + callBackFun);
}
RequestArray.shift(); // 移除已完成的第一筆
ExeRequestArray(); // 繼續下一筆
}
}
一、別用字串呼叫函式。原寫法以 eval(callBackFun + "(reqObj)") 動態執行,這既不安全也不利于除錯。直接把函式當成參數傳入即可,上面已改為透過 window[callBackFun] 查表呼叫;更好的做法是乾脆傳函式參照本身。
二、請求失敗也要出列。若請求逾時或徹底失敗而 readyState 一直停在 1、2,佇列就會卡住。建議加上逾時計時器,逾時即中止並移出該筆,讓後續請求得以繼續。
三、考慮用 Promise 取代回呼。今日更簡潔的寫法是讓每個請求回傳一個 Promise,再用 async/await 搭配 for...of 迴圈循序等待,程式碼可讀性遠勝手刻佇列:
for (const task of tasks) {
const data = await fetch(task.url).then(r => r.json());
render(data);
}
若需要控制併發數量而非完全序列化,也可以自行實作一個併發上限為 n 的執行器,在吞吐與伺服器負擔之間取得平衡。
請求排隊的本質是「把非同步流程改造成可控的序列」。手刻佇列的價值在於理解 XHR 的生命周期與狀態變化;而在實際專案中,選用 Promise 或成熟的請求庫,通常能少寫很多邊緣情況的處理。