$ .ajaxSetup()方法為將來的Ajax請求設(shè)置默認值。
除非被各個調(diào)用覆蓋,否則所有使用任何方法進行的后續(xù)Ajax調(diào)用都將使用新設(shè)置,直到下次調(diào)用$ .ajaxSetup()為止。
$.ajaxSetup({name:value, name:value, ...})設(shè)置所有AJAX請求的默認URL:
$.ajaxSetup({
url: "ajax_post.php"
});
//現(xiàn)在每次發(fā)出Ajax請求時,都會自動使用“ ajax_post.php” URL:
$.ajax({
data: {fname:"Seagull", lname:"Anna"},
method: "POST",
success: function(response){
$("div").html(response);
}
});測試看看?/?為所有AJAX請求設(shè)置默認的URL和成功函數(shù):
$.ajaxSetup({
url: "ajax_data.txt",
success: function(response){
$("div").html(response);
}
});
$("button").click(function(){
$.ajax();
});測試看看?/?如果Ajax請求遇到錯誤,則顯示通知:
$.ajaxSetup({
url: "wrong_file.html",
success: function(response){
$("div").html(response);
},
error: function(xhr){
$("div").html("發(fā)生錯誤: " + xhr.status + " " + xhr.statusText);
}
});
$("button").click(function(){
$.ajax();
});測試看看?/?注意:此處指定的設(shè)置將影響對$ .ajax或基于Ajax的派生類(如$ .get())的所有調(diào)用。由于其他調(diào)用者(例如插件)可能期望使用正常的默認設(shè)置,因此這可能導致不良行為。因此,強烈建議您不要使用$ .ajaxSetup()方法。而是在調(diào)用中顯式設(shè)置選項或定義一個簡單的插件即可。
參數(shù)使用一個或多個name:value對指定AJAX請求的設(shè)置。
可能的名稱:下表中的值:
| 名稱 | 值類型 | 描述 |
|---|---|---|
| async | 布爾型 | 一個布爾值,指示是否應(yīng)異步處理請求。默認為true |
| beforeSend(xhr) | 函數(shù) | 發(fā)送請求之前運行的函數(shù) |
| cache | 布爾型 | 一個布爾值,指示瀏覽器是否應(yīng)緩存請求的頁面。默認為true |
| complete(xhr,status) | 函數(shù) | 請求完成后要運行的函數(shù)(成功和錯誤功能之后) |
| contentType | 布爾值或字符串 | 將數(shù)據(jù)發(fā)送到服務(wù)器時使用的內(nèi)容類型。默認值為:“ application / x-www-form-urlencoded” |
| context | 普通對象 | 為所有與AJAX相關(guān)的回調(diào)函數(shù)指定“ this”值 |
| data | PlainObject或String或Array | 指定要發(fā)送到服務(wù)器的數(shù)據(jù) |
| dataFilter(data,type) | 函數(shù) | 用于處理XMLHttpRequest的原始響應(yīng)數(shù)據(jù)的函數(shù) |
| dataType | 字符串 | 服務(wù)器響應(yīng)預期的數(shù)據(jù)類型 |
| error(xhr,status,error) | 函數(shù) | 請求失敗時運行的函數(shù) |
| global | 布爾型 | 一個布爾值,指定是否觸發(fā)請求的全局AJAX事件句柄。默認為true |
| ifModified | 布爾型 | 一個布爾值,指定是否只有在自上一個請求以來響應(yīng)已更改的情況下,請求才成功。默認值為:false。 |
| jsonp | 字符串或布爾 | 覆蓋jsonp請求中的回調(diào)函數(shù) |
| jsonpCallback | 函數(shù) | 為jsonp請求中的回調(diào)函數(shù)指定名稱 |
| method | 字符串 | 指定用于請求的HTTP方法。(獲取或發(fā)布)。默認為GET |
| password | 字符串 | 指定在HTTP訪問認證請求中使用的密碼 |
| processData | 布爾型 | 一個布爾值,指定是否應(yīng)將與請求一起發(fā)送的數(shù)據(jù)轉(zhuǎn)換為查詢字符串。默認為true |
| scriptCharset | 字符串 | 指定請求的字符集 |
| statusCode | 普通對象 | 響應(yīng)具有相應(yīng)代碼時將調(diào)用數(shù)字HTTP代碼和函數(shù)的對象$ .ajax({
statusCode:{
404:function(){
alert(“找不到頁面”);
}
}
}); |
| success(response,status,xhr) | 函數(shù) | 請求成功時要運行的函數(shù) |
| timeout | 數(shù)字 | 請求的本地超時(以毫秒為單位) |
| traditional | 布爾型 | 一個布爾值,指定是否使用傳統(tǒng)的參數(shù)序列化樣式 |
| type | 字符串 | method的別名。如果您使用的是1.9.0之前的jQuery版本,則應(yīng)使用type |
| url | 字符串 | 指定將請求發(fā)送到的URL。默認為當前頁面 |
| username | 字符串 | 指定要在HTTP訪問認證請求中使用的用戶名 |
| xhr | 函數(shù) | 用于創(chuàng)建XMLHttpRequest對象的函數(shù) |