有時候程式的設計是「一次送出大量請求」,例如批次匯入、逐筆送出表單。這時就會遇到兩個需求:中途想要全部停掉,以及避免請求堆積失控。
關鍵在於:把每次 $.ajax() 的回傳值存起來。那個回傳值是 jqXHR 物件,上面有 abort() 方法,呼叫它就能中止對應的請求。
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>jQuery中終止Ajax請求</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<script src="https://common.cnblogs.com/script/jquery.js" type="text/javascript"></script>
<script>
var arrayAJAX = new Array();
$(function () {
$("#btn").bind("click", function () {
for (var i = 0; i < 100; i++) {
starAJAX(i);
}
});
$("#bt2").bind("click", function () {
stopAJAX();
alert("終止AJAX請求");
});
});
// 停止全部 ajax
function stopAJAX() {
for (var i = 0; i < arrayAJAX.length; i++) {
arrayAJAX[i].abort();
}
arrayAJAX = new Array();
}
// 送出並登記一個 ajax
function starAJAX(i) {
var options = {
url: '/Home/addallrecommandbook',
data: "html=" + i,
success: function (data, textStatus) {
if (textStatus == 'success') {
alert("添加成功!");
}
},
error: function (x, msg, err) { }
};
// 把回傳的 jqXHR 物件推進佇列
arrayAJAX.push($.ajax(options));
}
</script>
</head>
<body>
<input type="button" id="btn" value="starAJAX" />
<input type="button" id="bt2" value="stopAjax" />
</body>
</html>
$.ajax() 會立刻回傳一個 jqXHR 物件,同時請求在背景進行。把它 push 進陣列,就等於握住了每一個請求的控制權。stopAJAX() 做的事就是逐一呼叫 abort(),然後清空陣列。
被 abort 的請求會進入 error 分支,textStatus 的值是 "abort"。因此實務上應該在 error 裡做判斷,避免把「使用者主動取消」誤報為真正的錯誤:
error: function (x, msg, err) {
if (msg === 'abort') { return; } // 主動取消,靜默處理
console.log('請求失敗:', msg);
}
這個標題裡的「疊加」可以指兩件事,值得分開談:
一種是刻意併發——像上例那樣同時發出一百個請求。這在瀏覽器我被限制下不會真的同時送出(同網域通常只允許 6 條連線),但其餘會排隊等待,容易造成體感上的延遲。
另一種是連點造成的重複送出——使用者連是按鈕,每次都觸發一次請求。解法是在請求進行期間停用按鈕:
$("#btn").click(function () {
var $btn = $(this).prop("disabled", true);
$.ajax({
url: "...",
complete: function () { $btn.prop("disabled", false); }
});
});
用 complete 而非 success 來恢復按鈕,是因為不論成功或失敗都要解鎖,否則一次失敗按鈕就永久卡住了。