$.ajax() 是 jQuery 與後端溝通的核心,參數雖多,但真正需要深究的其實集中在幾個。以下依重要度整理,並附基本範例與一個較完整的應用。
$.ajax({
url: 'test.do',
data: { id: 123, name: 'xiaoming' },
type: 'post',
dataType: 'json',
success: function(data) {
alert(data);
// TODO 處理回應
},
error: function(data) {
alert(data);
// TODO 錯誤處理
}
});
$.ajaxSetup() 的全域設定。長時間查詢建議一定要設,否則使用者只會看到轉圈圈。{foo1:"bar1",foo2:"bar2"} 轉為 ?foo1=bar1&foo2=bar2;陣列則會產生同名的多筆,例如 {foo:["bar1","bar2"]} 轉為 ?foo=bar1&foo=bar2。application/x-www-form-urlencoded,適合大多數情況。要送 JSON 時改為 application/json。若不指定,jQuery 會依 HTTP 回應的 MIME 自動判斷,再以 responseXML 或 responseText 傳給 callback。可選值:
myurl?callback=? 時,jQuery 會自動把最後一個 ? 替換為產生的函式名以執行回呼。也可用 jsonp 參數自訂 callback 參數名。送出前可修改 XMLHttpRequest 物件,例如加上自訂 HTTP 標頭;在此 return false 可取消本次請求。
beforeSend: function(XMLHttpRequest) {
this; // 本次 ajax 請求傳入的 options
}
請求完成後(不論成功或失敗)都會呼叫,參數為 XMLHttpRequest 與描述狀態的字串。
complete: function(XMLHttpRequest, textStatus) {
this; // 本次請求的 options
}
成功時呼叫,兩個參數:經 dataType 處理後的資料,以及狀態字串。
success: function(data, textStatus) {
// data 可能是 xmlDoc、jsonObj、html、text 等
this; // 本次請求的 options
}
失敗時呼叫,參數為 XMLHttpRequest、錯誤資訊、捕捉到的錯誤物件。
error: function(XMLHttpRequest, textStatus, errorThrown) {
// 通常 textStatus 與 errorThrown 只有一個帶有資訊
this; // 本次請求的 options
}
dataFilter: function(data, type) {
return data; // 處理後的資料
}
ajaxStart / ajaxStop 之類的全域 loading 遮罩。{jsonp:'onJsonPLoad'} 會把 onJsonPLoad=? 傳給伺服器。$(function(){
$('#send').click(function(){
$.ajax({
type: "GET",
url: "test.json",
data: {
username: $("#username").val(),
content: $("#content").val()
},
dataType: "json",
beforeSend: function(xhr) {
xhr.setRequestHeader("Accept", "application/json");
},
success: function(data){
$('#resText').empty();
var html = '';
$.each(data, function(commentIndex, comment){
html += '<div class="comment">'
+ '<span class="user">' + comment['username'] + '</span>'
+ '<p>' + comment['content'] + '</p>'
+ '</div>';
});
$('#resText').html(html);
},
error: function(xhr, textStatus, errorThrown){
console.log(textStatus, errorThrown);
},
complete: function(){
$('#send').removeAttr('disabled');
}
});
});
});
async: false 來「湊」同步流程,改用 Promise / $.when() 串接,畫面才不會凍住。success / error / complete 已標記為不建議使用,改用 .done() / .fail() / .always() 或 $.ajax().then(),風格上也更貼近標準 Promise。$(document).ajaxStart() / ajaxStop(),並對不需顯示 loading 的請求設 global: false。以上就是 $.ajax() 的參數整理,希望對你的學習有所幫助。