在開發 Ajax 應用時,jQuery 大幅提升了效率並解決了許多相容性問題。然而,當非同步請求出錯時,我們該如何取得錯誤資訊並除錯呢?答案就是善用 error 事件。本文將詳細說明 Ajax 的成功與失敗回呼,以及如何透過 error 函數定位問題。
$(document).ready(function() {
jQuery("#clearCac").click(function() {
jQuery.ajax({
url: url,
type: "post",
data: { id: '0' },
dataType: "json",
success: function(msg) {
alert(msg);
},
error: function(XMLHttpRequest, textStatus, errorThrown) {
alert(XMLHttpRequest.status);
alert(XMLHttpRequest.readyState);
alert(textStatus);
},
complete: function(XMLHttpRequest, textStatus) {
this; // 呼叫本次 AJAX 請求時傳遞的 options 參數
}
});
});
});
當請求成功時會呼叫 success 函數,它接收兩個參數:伺服器返回的資料與狀態:
// 請求成功後的回呼函數
function (data, textStatus) {
// data 可能是 xmlDoc、jsonObj、html、text 等
this; // 本次 ajax 請求的 options 參數
}
當請求失敗時會呼叫 error 函數,它接收三個參數:XMLHttpRequest 物件、錯誤資訊,以及(可選的)捕獲的錯誤物件。其中 textStatus 除了 null 之外,還可能是 "timeout"、"error"、"notmodified" 或 "parsererror":
// 請求失敗時的回呼函數
error: function (XMLHttpRequest, textStatus, errorThrown) {
// 處理錯誤
}
error 事件的觸發可能有多種原因,以下兩個是最常見的:
header('Content-type: text/html; charset=utf8');透過 error 回呼搭配 readyState 與 textStatus 的資訊,我們就能精準定位 Ajax 請求失敗的原因。希望本文能對你的 jQuery 程式設計有所幫助。