AJAX 是實現非同步網頁互動的核心技術,而 jQuery 的 $.ajax() 則是最靈活、最完整的呼叫方式。本文將完整梳理它的各項參數,並著重說明如何在請求失敗時進行有效的錯誤除錯。
error 函式是除錯的關鍵:
error: function(XMLHttpRequest, textStatus, errorThrown) {
alert(XMLHttpRequest.status);
alert(XMLHttpRequest.readyState);
alert(textStatus);
}
其中 textStatus 除了 null 之外,還可能是 "timeout"、"error"、"notmodified" 與 "parsererror"。
XMLHttpRequest.readyState:
一、data 即使為空也要傳 "{}"。否則可能回傳 xml 格式並觸發 parsererror。
二、parsererror 與 Header 型別有關。後端需正確設定 header('Content-type: text/html; charset=utf8');。
三、善用 XMLHttpRequest.status。它能回報完整的 HTTP 狀態碼(如 200 成功、301/302 重定向、400/401/403/404 客戶端錯誤、500 系列伺服器錯誤等),是判斷請求結果的重要依據。
掌握 $.ajax() 的參數與錯誤處理機制,就能寫出既穩定又易於除錯的非同步請求。建議在正式環境中,務必為 error 與 complete 加上適當的處理邏輯,讓使用者遇到問題時能获得清楚的回饋。