當伺服器要回傳的內容很大時,等全部下載完才一次顯示,使用者只能盯著空白畫面。若能在傳輸過程中就把已收到的部分逐步呈現,體驗會好很多。做法是開一個定時器,反覆檢查 XHR 目前的狀態並更新畫面,等傳輸結束再清掉定時器。
function ajax_stream(url, data, element) {
var xmlHttp = null;
if (window.XMLHttpRequest) {
xmlHttp = new XMLHttpRequest(); // IE7+、Firefox、Opera 等
} else if (window.ActiveXObject) {
xmlHttp = new ActiveXObject("Microsoft.XMLHTTP"); // IE6、IE5
}
if (xmlHttp == null) {
alert("您的瀏覽器不支援 XMLHTTP。");
element.val('不支援 XMLHTTP,請改用其他瀏覽器。');
return 0;
}
var xhr = xmlHttp;
xhr.open('POST', url, true);
// 若要像 HTML 表單那樣 POST 資料,需先設定 header
xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded");
xhr.send(data);
var timer;
timer = window.setInterval(function () {
if (xhr.readyState == XMLHttpRequest.DONE) {
window.clearTimeout(timer);
}
element.val(xhr.responseText);
}, 1000);
}
關鍵在最後那段:每秒讀一次 responseText 並更新畫面。因為 responseText 在 readyState 為 3(LOADING)時就會持續累加已收到的內容,所以不需要分段解析,直接整串重寫即可。傳輸完成後把定時器清掉,避免無謂的輪詢。
標準的 send() 只接受以下幾種類型:
void send(); void send(ArrayBuffer data); void send(Blob data); void send(Document data); void send(DOMString? data); void send(FormData data);
也就是說,物件必須先轉成字串或 FormData 才能送出。這一點確實不如 jQuery 的 $.ajax 方便,但 jQuery 在傳輸中途要怎麼攔截事件並不清楚,所以這裡選擇原生寫法。
function ajax_generate_data(jsobj) {
var i, data;
if (window.FormData) {
data = new FormData();
for (i in jsobj) {
data.append(i, jsobj[i]);
}
} else {
var datas = [];
for (i in jsobj) {
// 編碼,避免值裡出現的特殊字元破壞格式
var value = encodeURIComponent(jsobj[i]);
datas.push(i + '=' + value);
}
data = datas.join('&');
}
console.log(data);
return data;
}
有 FormData 就用它(記得這種情況下不要手動設定 Content-Type,讓瀏覽器自動補上 boundary),不支援時退回傳統的查詢字串拼接。
輪詢間隔與效能:一秒一次是折衷值。若內容極大,每次重設 element.val() 會重新排版整塊文字,可能反而變卡。可以改成只比對長度變化、把新增的部分 append 上去,或降低更新頻率到 200~300 毫秒但只更新差量。
用 clearTimeout 清 setInterval:原範例用 clearTimeout 清除 setInterval 的識別碼。在部分瀏覽器上兩者共用同一組 ID 池所以剛好能用,但語意上應該用 clearInterval,比較保險。
更現代的替代方案:如今若目標是真正的逐段串流,fetch 搭配 ReadableStream 的 reader 是更好的選擇,可以取得真正的資料分塊而非依賴輪詢;若要處理 Server-Sent Events,直接用 EventSource 更省事。上面這套 XHR 輪詢寫法適合用於需要相容舊環境或後端只能回傳單一長字串的情況。