DIV CSS 佈局教程網

用 jQuery Ajax 的 error 事件排查請求失敗
編輯:JQuery特效代碼     

jQuery 讓 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 與 error 的簽名

成功時:

// 請求成功後的回調函數,參數為伺服器回傳資料與狀態
function (data, textStatus) {
    // data 可能是 xmlDoc、jsonObj、html、text 等
    this;   // 本次 ajax 請求的 options
}

失敗時:

// 請求失敗時呼叫
// 參數:XMLHttpRequest 物件、錯誤資訊、(可選)捕獲的錯誤物件
// textStatus 除了 null 之外,可能是 "timeout"、"error"、"notmodified"、"parsererror"
error: function (XMLHttpRequest, textStatus, errorThrown) {
}

readyState 的意義

error 回呼的第一個參數 XMLHttpRequest 上的 readyState 可以幫你判斷卡在哪一步:

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

兩個容易忽略的引發點

除了網路層面的問題,下面這兩點最常造成 error:

  1. data 傳空字串:即使沒有參數要送,也要寫成 data: "{}",否則伺服器可能回傳 XML 格式,前端就會跳 parsererror。
  2. Content-Type 與編碼:parsererror 與回應標頭有關,後端記得明確輸出 header('Content-type: text/html; charset=utf8');,讓前端能正確解析。

把 error 裡的三個參數都印出來,通常一眼就能看出是格式問題、逾時,還是伺服器真的丟了錯誤。

希望這篇對大家的 jQuery 開發有幫助。

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