萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 取消 AJAX 請求:xhr.abort() 正確用法與伺服器端行為說明

jQuery AJAX 回傳的 jqXHR 物件實作了 abort() 方法,可在回應前取消請求。但需明確理解:僅取消客戶端監聽,已發送至伺服器的請求仍會繼續處理。

基本用法

var xhr = $.ajax({
  type: "POST",
  url: "test.php",
  data: "name=test",
  success: function(msg) { alert(msg); }
});

// 使用者取消、超時、切換頁面時呼叫
xhr.abort();

生命週期與狀態

階段abort() 效果伺服器端
請求未發送 (佇列中)取消發送,不觸發任何回調未收到請求
請求已發送,等待回應觸發 error 回調 (statusText="abort"),complete 仍觸發繼續處理,回應將被瀏覽器丟棄
回應已接收,處理中中斷回調執行,complete 仍觸發已完成處理

完整取消流程範例:搜尋建議防抖 + 取消上一請求

var searchXHR = null;
$('#searchInput').on('input', function() {
  var query = $(this).val();
  if (searchXHR) { searchXHR.abort(); } // 取消前一次未完成請求

  searchXHR = $.ajax({
    url: '/api/suggest',
    data: { q: query },
    success: function(data) { renderSuggestions(data); }
  });
});

$(window).on('beforeunload', function() {
  if (searchXHR) searchXHR.abort(); // 頁面卸載時清理
});

進階:Promise 介面 (jQuery 3+)

var promise = $.ajax({ ... });
// 標準 Promise 方法
promise.then(success, error).always(complete);

// 取消仍用 abort()
promise.abort(); // jqXHR 繼承 Promise,但保留 abort()

伺服器端配合建議

  • 冪等操作 (GET、查詢) 直接忽略中斷無副作用
  • 非冪等操作 (POST/PUT/DELETE) 應實現冪等鍵 或事務回滾,避免重複提交導致資料不一致
  • 長時間運算任務:定期檢查客戶端連線狀態 (如 PHP connection_aborted()),主動終止釋放資源

常見誤區

  • 誤以為 abort() 能撤回伺服器操作 — 不能
  • 未保存 xhr 變數導致無法呼叫 abort()
  • 在 beforeSend 返回 false 可取消發送,但 abort() 更通用
copyright © 萬盛學電腦網 all rights reserved