$ .ajaxSetup()方法為將來的Ajax請求設(shè)置默認(rèn)值。
除非被各個調(diào)用覆蓋,否則所有使用任何方法進行的后續(xù)Ajax調(diào)用都將使用新設(shè)置,直到下次調(diào)用$ .ajaxSetup()為止。
$.ajaxSetup({name:value, name:value, ...})
設(shè)置所有AJAX請求的默認(rèn)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è)置默認(rèn)的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)用者(例如插件)可能期望使用正常的默認(rèn)設(shè)置,因此這可能導(dǎo)致不良行為。因此,強烈建議您不要使用$ .ajaxSetup()方法。而是在調(diào)用中顯式設(shè)置選項或定義一個簡單的插件即可。
參數(shù)使用一個或多個name:value對指定AJAX請求的設(shè)置。
可能的名稱:下表中的值:
名稱 | 值類型 | 描述 |
---|---|---|
async | 布爾型 | 一個布爾值,指示是否應(yīng)異步處理請求。默認(rèn)為true |
beforeSend(xhr) | 函數(shù) | 發(fā)送請求之前運行的函數(shù) |
cache | 布爾型 | 一個布爾值,指示瀏覽器是否應(yīng)緩存請求的頁面。默認(rèn)為true |
complete(xhr,status) | 函數(shù) | 請求完成后要運行的函數(shù)(成功和錯誤功能之后) |
contentType | 布爾值或字符串 | 將數(shù)據(jù)發(fā)送到服務(wù)器時使用的內(nèi)容類型。默認(rèn)值為:“ 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)預(yù)期的數(shù)據(jù)類型 |
error(xhr,status,error) | 函數(shù) | 請求失敗時運行的函數(shù) |
global | 布爾型 | 一個布爾值,指定是否觸發(fā)請求的全局AJAX事件句柄。默認(rèn)為true |
ifModified | 布爾型 | 一個布爾值,指定是否只有在自上一個請求以來響應(yīng)已更改的情況下,請求才成功。默認(rèn)值為:false。 |
jsonp | 字符串或布爾 | 覆蓋jsonp請求中的回調(diào)函數(shù) |
jsonpCallback | 函數(shù) | 為jsonp請求中的回調(diào)函數(shù)指定名稱 |
method | 字符串 | 指定用于請求的HTTP方法。(獲取或發(fā)布)。默認(rèn)為GET |
password | 字符串 | 指定在HTTP訪問認(rèn)證請求中使用的密碼 |
processData | 布爾型 | 一個布爾值,指定是否應(yīng)將與請求一起發(fā)送的數(shù)據(jù)轉(zhuǎn)換為查詢字符串。默認(rè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。默認(rèn)為當(dāng)前頁面 |
username | 字符串 | 指定要在HTTP訪問認(rèn)證請求中使用的用戶名 |
xhr | 函數(shù) | 用于創(chuàng)建XMLHttpRequest對象的函數(shù) |