Ajax 是後端與前端溝通的主要管道,而 jQuery 的 $.ajax() 把麻煩的 XMLHttpRequest 差異都處理掉了,我們只要把選項填對即可。本文整理最常用到的幾個參數。
JSON(JavaScript Object Notation)是一種輕量級的資料交換格式,特性是與平台無關、可讀性高,因此在 Ajax 溝通中幾乎是標準配備。
常見的兩種轉換:
1. Java 物件轉 JSON 字串:後端可用 Jackson 的 ObjectMapper,呼叫 writeValueAsString(物件)。
2. JSON 字串轉 JavaScript 物件:用 JS 內建的 JSON.parse()。若回傳的是物件組成的陣列字串,同樣用 parse 處理即可。
補充一個實務重點:早期程式碼常看到 eval("("+data+")") 這種寫法,它會執行字串中的任意程式碼,存在 XSS 風險,請一律改用 JSON.parse()。
$.ajax({
url: "請求位址(相對路徑或完整 URL)",
type: "請求方法,get / post",
data: {
// 可以是物件形式,jQuery 會自動序列化成查詢字串
"adminCode": "king",
"age": 22
},
// 也可以是字串形式:"adminCode=king&age=22"
dataType: "伺服器預期回傳的資料型別",
// "json" → 自動轉為 JavaScript 物件
// "text" → 純文字字串
// "html" → HTML 片段
// "xml" → XML 文件
// "script" → 直接執行 JavaScript
success: function(response){
// 請求成功時的處理,response 已依 dataType 轉好
},
error: function(xhr, status, error){
// 請求失敗(4xx / 5xx、逾時、斷網等)
}
});
dataType 是「告訴 jQuery 回傳什麼」。如果伺服器明明回 JSON 卻沒設 dataType,jQuery 會依 Content-Type 猜測,猜錯時 success 收到的會是字串,此時 JSON.parse 之前要先確認型別。
type 預設是 GET。要送出敏感資料或大量內容時請用 POST,並注意 GET 的參數會出現在網址上、留下瀏覽紀錄。
別忘了 timeout。不設逾時的請求可能永遠掛著,載入畫面一直轉。實務上建議加上 timeout 並在 error 中給使用者友善提示。
其餘值得知道的選項:
async(是否非同步,預設 true,設 false 會凍結整個頁面,強烈不建議)、beforeSend(可在送出前修改 request header)、cache(GET 請求的快取控制)、context(回呼中的 this 指向)、traditional(參數序列化方式)。
如果只是一次簡單請求,也可以直接用語意更清楚的簡寫:$.getJSON()、$.getScript()、$.post(),本質上都是 $.ajax 的包裝。