DIV CSS 佈局教程網

jQuery AJAX timeout 超時問題完整解析與處理
編輯:關於JavaScript     

AJAX 請求「一直轉圈圈」是後台開發最常見的抱怨之一。要處理它,得先知道超時從哪來、jQuery 怎麼判定超時,以及如何在超時時優雅地補救。

超時的兩個常見原因

  1. 網路不順:延遲高、封包遺失,請求遲遲得不到回應。
  2. 後端處理慢:第一次執行時特別明顯,例如需要初始化、查詢大量資料或等待外部服務。

jQuery 在 AJAX 設定中提供了 timeout 參數(單位毫秒)。若伺服器回應時間超過這個值,請求就會進入 error 處理流程,並把 textStatus 設為 "timeout"。

三種處理策略

  1. timeout 預設為 0,代表永不超時。這通常不是好主意,請求可能永遠掛著。
  2. 把 timeout 設大一點。缺點是資料載入變慢時使用者會等更久。
  3. 在 error 回呼裡針對超時做補救,例如自動重試一次取資料的函數。

基本寫法

對 jQuery 來說,超時處理非常直接:設定 timeout,並在 error 事件中檢查第二個參數是否為 "timeout"。

$.ajax({
  type: "POST",
  contentType: "application/json",
  url: "../ws/MyService.asmx/test",
  data: '{"email":"' + email + '"}',
  timeout: 30000,   // 超時時間:30 秒
  dataType: 'json',
  error: function (XMLHttpRequest, textStatus, errorThrown) {
    // textStatus 除了 null 之外,還可能是:
    // "timeout"、"error"、"notmodified"、"parsererror"
    if (textStatus === 'timeout') {
      // 這裡做超時的補救處理,例如提示使用者或重試
    }
  },
  success: function (result) {
    // 處理回傳結果
  }
});

error 回呼裡能拿到的資訊

第一個參數 XMLHttpRequest 有兩個很有用的屬性。

readyState:請求的階段狀態

  • 0 — 未初始化,尚未呼叫 send()
  • 1 — 載入中,send() 已呼叫,正在送出請求
  • 2 — 載入完成,send() 執行完畢,已收到全部回應內容
  • 3 — 互動中,正在解析回應內容
  • 4 — 完成,回應解析完畢,用戶端可以使用了

status:HTTP 狀態碼,依百位分類判斷即可:

  • 1xx 資訊提示:100 繼續、101 切換協議。屬於暫時性回應。
  • 2xx 成功:200 確定、201 已建立、202 已接受、204 無內容、206 部分內容。
  • 3xx 重定向:301 永久移動、302 暫時移動、304 未修改、307 暫時重定向。
  • 4xx 用戶端錯誤:400 錯誤的請求、401 未授權、403 禁止存取、404 未找到、405 方法不允許、408 請求超時、413 請求實體太大、414 URI 太長、415 不支援的媒體類型。
  • 5xx 伺服器端錯誤:500 內部伺服器錯誤、502 閘道錯誤、503 服務不可用、504 閘道超時、505 HTTP 版本不支援。

其中 IIS 會把 401 與 403 細分出更多子碼,例如 401.1 登入失敗、403.1 執行存取被禁止、403.4 需要 SSL 等,除錯時看子碼能大幅縮小範圍。FTP 協定也有自己的一套回覆碼:1xx 表示已開始、2xx 表示成功完成(如 230 使用者已登入、226 資料傳輸完成)、3xx 需要更多資訊(331 需要密碼)、4xx 暫時性失敗(425 無法開啟資料連接)、5xx 永久性失敗(530 未登入、550 檔案不可用)。常見的 150 則是告知伺服器準備在資料埠上傳輸。

ExtJS 的超時處理對照

順帶一提,ExtJS 預設超時是 30 秒,超過同樣會回傳 HTTP 408。它的設定方式不同,需要用 Ext.data.Connection 並攔截 requestexception 事件:

var conn = new Ext.data.Connection({
  url: "../ws/MyService.asmx/test",
  timeout: 60000,      // 自訂超時時間(預設 30 秒)
  autoAbort: false,
  disableCaching: true,
  method: "GET"
});

var proxy = new Ext.data.HttpProxy(conn);

proxy.getConnection().on("requestcomplete", function (sender, response, options){
  // 成功:response.status = 200,response.statusText = 'OK'
});

proxy.getConnection().on("requestexception", function (sender, response, options){
  // 異常:可取 response.status(HTTP 狀態碼)與 response.statusText
});

var store = new Ext.data.Store({
  proxy: proxy,
  reader: myReader,
  baseParams: { myargument: 'myargumentValue' },
  remoteSort: false
});
store.load();

實務上的建議:與其把 timeout 設得很大來「等得起」,不如同時優化後端回應速度,並在超時時給使用者明確的回饋與重試機會。無聲的等待,才是最傷使用者體驗的。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved