AJAX 請求「一直轉圈圈」是後台開發最常見的抱怨之一。要處理它,得先知道超時從哪來、jQuery 怎麼判定超時,以及如何在超時時優雅地補救。
jQuery 在 AJAX 設定中提供了 timeout 參數(單位毫秒)。若伺服器回應時間超過這個值,請求就會進入 error 處理流程,並把 textStatus 設為 "timeout"。
timeout 預設為 0,代表永不超時。這通常不是好主意,請求可能永遠掛著。timeout 設大一點。缺點是資料載入變慢時使用者會等更久。對 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) {
// 處理回傳結果
}
});
第一個參數 XMLHttpRequest 有兩個很有用的屬性。
readyState:請求的階段狀態
send()send() 已呼叫,正在送出請求send() 執行完畢,已收到全部回應內容status: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 預設超時是 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 設得很大來「等得起」,不如同時優化後端回應速度,並在超時時給使用者明確的回饋與重試機會。無聲的等待,才是最傷使用者體驗的。