jQuery 提供多種 Ajax 呼叫方式,其中 $.ajax 是底層實作,$.post 與 $.get 則是包好的高階捷徑。本文把兩者的參數與適用時機整理成對照說明。若你對 JavaScript 與 Ajax 概念還不熟,建議先打好基礎再往下讀。
這是 jQuery 的底層 Ajax 實作,回傳它建立的 XMLHttpRequest 物件。在大多數情況下你不需要直接操作這個物件,但特殊情境下可以用它手動中止請求。
一個要特別注意的點:如果指定了 dataType,請確認伺服器回傳正確的 MIME 型別(例如 XML 要回 text/xml),錯誤的 MIME 會導致難以預料的錯誤。另外,當 dataType 設為 'script' 時,所有跨域的 POST 請求都會被轉成 GET。
自 jQuery 1.2 起可以跨域載入 JSON 資料,做法是使用 JSONP:把型別設為 jsonp,並在網址中寫成 "myurl?callback=?",jQuery 會自動把 ? 換成正確的函式名。
application/x-www-form-urlencoded,適合大多數情況。{foo:["bar1","bar2"]} 轉為 &foo=bar1&foo=bar2。xml、html(可含 script)、script(不會被快取)、json、jsonp。// beforeSend
function (XMLHttpRequest) {
this; // 此次請求的 options
}
// complete
function (XMLHttpRequest, textStatus) {
this; // 此次請求的 options
}
// error
function (XMLHttpRequest, textStatus, errorThrown) {
// 通常 textStatus 與 errorThrown 只有一個有值
this; // 此次請求的 options
}
// success
function (data, textStatus) {
// data 可能是 xmlDoc、jsonObj、html、text...
this; // 此次請求的 options
}
$.ajax({
type: 'get',
url: 'https://www.example.com/rss',
beforeSend: function (XMLHttpRequest) {
// ShowLoading();
},
success: function (data, textStatus) {
$('.ajax.ajaxResult').html('');
$('item', data).each(function (i, domEle) {
$('.ajax.ajaxResult').append('<li>' + $(domEle).children('title').text() + '</li>');
});
},
complete: function (XMLHttpRequest, textStatus) {
// HideLoading();
},
error: function () {
// 請求出錯處理
}
});
用 POST 方式發送非同步請求,是 $.ajax 的簡化版:
$.post('ajax.php', { Action: "post", Name: "lulu" }, function (data, textStatus) {
// data 可能是 xmlDoc、jsonObj、html、text
alert(data.result);
}, "json");
如果需要在出錯時做處理,就得改用 $.ajax,因為 $.post 沒有 error 參數。
當你把請求格式設為 json,伺服器端就必須把 Content-Type 設為 application/json,否則前端拿不到資料。另外因為已經宣告 Accept 為 json,jQuery 會自動把回應解析成物件,不需要再用 eval()——用 eval 解析 JSON 除了多餘,還有安全性風險,應一律改用 JSON.parse() 或直接依賴 jQuery 的自動解析。
最後補充:jQuery 3.x 已把 success / error / complete 這些選項標記為 deprecated,建議改用 $.ajax().done().fail().always() 或 await 搭配 Promise 的寫法。