DIV CSS 佈局教程網

全面解析 jQuery.ajax 的參數設定與錯誤除錯技巧
編輯:JQuery特效代碼     

AJAX 是實現非同步網頁互動的核心技術,而 jQuery 的 $.ajax() 則是最靈活、最完整的呼叫方式。本文將完整梳理它的各項參數,並著重說明如何在請求失敗時進行有效的錯誤除錯。

核心參數一覽

  • url:請求的目標位址,預設為當前頁。
  • type:請求方式,預設 GET,也可使用 POST 等。
  • timeout:請求逾時的毫秒數,會覆蓋全域設定。
  • async:預設 true 為非同步;設為 false 則為同步,但會鎖住瀏覽器。
  • beforeSend:送出請求前可修改 XMLHttpRequest 物件的函式,例如加上自訂 HTTP 標頭。
  • cache:設為 false 可避免從瀏覽器快取載入請求。
  • complete:無論成功或失敗都會呼叫的回呼函式。
  • contentType:預設為 application/x-www-form-urlencoded。
  • data:送往伺服器的資料,需為 Key/Value 格式。
  • dataType:預期回傳型別,可為 xml、html、script、json、jsonp 等。
  • error:請求失敗時呼叫,含三個參數。
  • success:請求成功時呼叫,含回傳資料與狀態兩個參數。
  • global:是否觸發全域 AJAX 事件。
  • ifModified:僅在伺服器資料變動時才取新資料。
  • processData:預設會把資料轉為字串,若要傳 DOM 樹則設為 false。

錯誤回呼的寫法

error 函式是除錯的關鍵:

error: function(XMLHttpRequest, textStatus, errorThrown) {
  alert(XMLHttpRequest.status);
  alert(XMLHttpRequest.readyState);
  alert(textStatus);
}

其中 textStatus 除了 null 之外,還可能是 "timeout"、"error"、"notmodified" 與 "parsererror"。

error 事件回傳的關鍵資訊

XMLHttpRequest.readyState:

  • 0:尚未呼叫 send()
  • 1:已呼叫 send(),正在送出請求
  • 2:send() 執行完成,已收到全部回應內容
  • 3:正在解析回應內容
  • 4:回應內容解析完成,可供用戶端使用

幾個實務上常踩的雷

一、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 加上適當的處理邏輯,讓使用者遇到問題時能获得清楚的回饋。

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