$.ajax()方法參數(shù)詳解
1.url:
要求為String類型的參數(shù),(默認(rèn)為當(dāng)前頁地址)發(fā)送請求的地址。2.type:
要求為String類型的參數(shù)够坐,請求方式(post或get)默認(rèn)為get托嚣。注意其他http請求方法,例如put和delete也可以使用患久,但僅部分瀏覽器支持椅寺。3.timeout:
要求為Number類型的參數(shù),設(shè)置請求超時(shí)時(shí)間(毫秒)蒋失。此設(shè)置將覆蓋$.ajaxSetup()方法的全局設(shè)置返帕。4.async:
要求為Boolean類型的參數(shù),默認(rèn)設(shè)置為true高镐,所有請求均為異步請求溉旋。如果需要發(fā)送同步請求,請將此選項(xiàng)設(shè)置為false嫉髓。注意观腊,同步請求將鎖住瀏覽器邑闲,用戶其他操作必須等待請求完成才可以執(zhí)行。5.cache:
要求為Boolean類型的參數(shù)梧油,默認(rèn)為true(當(dāng)dataType為script時(shí)苫耸,默認(rèn)為false),設(shè)置為false將不會從瀏覽器緩存中加載請求信息儡陨。6.data:
要求為 Object或String類型的參數(shù)褪子,發(fā)送到服務(wù)器的數(shù)據(jù)。如果已經(jīng)不是字符串骗村,將自動轉(zhuǎn)換為字符串格式嫌褪。get請求中將附加在url后。防止這種自動 轉(zhuǎn)換胚股,可以查看 processData選項(xiàng)笼痛。對象必須為key/value格式,例如{foo1:"bar1",foo2:"bar2"}轉(zhuǎn)換 為&foo1=bar1&foo2=bar2琅拌。如果是數(shù)組缨伊,JQuery將自動為不同值對應(yīng)同一個(gè)名稱。例如{foo: ["bar1","bar2"]}轉(zhuǎn)換為&foo=bar1&foo=bar2进宝。7.dataType:
要求為String類型的參數(shù)刻坊,預(yù)期服務(wù)器返回的數(shù)據(jù)類型。如果不指定党晋,JQuery將自動根據(jù)http包mime信息返回responseXML或responseText谭胚,并作為回調(diào)函數(shù)參數(shù)傳遞∥床#可用的類型如下:
xml:返回XML文檔漏益,可用JQuery處理。
html:返回純文本HTML信息深胳;包含的script標(biāo)簽會在插入DOM時(shí)執(zhí)行绰疤。
script:返回純文本JavaScript代碼。不會自動緩存結(jié)果舞终。除非設(shè)置了cache參數(shù)轻庆。注意在遠(yuǎn)程請求時(shí)(不在同一個(gè)域下),所有post請求都將轉(zhuǎn)為get請求敛劝。
json:返回JSON數(shù)據(jù)余爆。
jsonp:JSONP格式。使用SONP形式調(diào)用函數(shù)時(shí)夸盟,例如myurl?callback=?蛾方,JQuery將自動替換后一個(gè)“?”為正確的函數(shù)名,以執(zhí)行回調(diào)函數(shù)。
text:返回純文本字符串桩砰。8.beforeSend:
要求為Function類型的參數(shù)拓春,發(fā)送請求前可以修改XMLHttpRequest對象的函數(shù),例如添加自定義HTTP頭亚隅。在beforeSend中如果返回false可以取消本次ajax請求硼莽。XMLHttpRequest對象是惟一的參數(shù)。
function(XMLHttpRequest){
this; //調(diào)用本次ajax請求時(shí)傳遞的options參數(shù)
}9.complete:
要求為Function類型的參數(shù)煮纵,請求完成后調(diào)用的回調(diào)函數(shù)(請求成功或失敗時(shí)均調(diào)用)懂鸵。參數(shù):XMLHttpRequest對象和一個(gè)描述成功請求類型的字符串。
function(XMLHttpRequest, textStatus){
this; //調(diào)用本次ajax請求時(shí)傳遞的options參數(shù)
}10.success:要求為Function類型的參數(shù)行疏,請求成功后調(diào)用的回調(diào)函數(shù)匆光,有兩個(gè)參數(shù)。
(1)由服務(wù)器返回酿联,并根據(jù)dataType參數(shù)進(jìn)行處理后的數(shù)據(jù)殴穴。
(2)描述狀態(tài)的字符串。
function(data, textStatus){
//data可能是xmlDoc货葬、jsonObj、html劲够、text等等
this; //調(diào)用本次ajax請求時(shí)傳遞的options參數(shù)
}11.error:
要求為Function類型的參數(shù)震桶,請求失敗時(shí)被調(diào)用的函數(shù)。該函數(shù)有3個(gè)參數(shù)征绎,即XMLHttpRequest對象蹲姐、錯(cuò)誤信息、捕獲的錯(cuò)誤對象(可選)人柿。ajax事件函數(shù)如下:
function(XMLHttpRequest, textStatus, errorThrown){
//通常情況下textStatus和errorThrown只有其中一個(gè)包含信息
this; //調(diào)用本次ajax請求時(shí)傳遞的options參數(shù)
}12.contentType:
要求為String類型的參數(shù)柴墩,當(dāng)發(fā)送信息至服務(wù)器時(shí),內(nèi)容編碼類型默認(rèn)為"application/x-www-form-urlencoded"凫岖。該默認(rèn)值適合大多數(shù)應(yīng)用場合江咳。13.dataFilter:
要求為Function類型的參數(shù),給Ajax返回的原始數(shù)據(jù)進(jìn)行預(yù)處理的函數(shù)哥放。提供data和type兩個(gè)參數(shù)歼指。data是Ajax返回的原始數(shù)據(jù),type是調(diào)用jQuery.ajax時(shí)提供的dataType參數(shù)甥雕。函數(shù)返回的值將由jQuery進(jìn)一步處理踩身。
function(data, type){
//返回處理后的數(shù)據(jù)
return data;
}14.dataFilter:
要求為Function類型的參數(shù),給Ajax返回的原始數(shù)據(jù)進(jìn)行預(yù)處理的函數(shù)社露。提供data和type兩個(gè)參數(shù)挟阻。data是Ajax返回的原始數(shù)據(jù),type是調(diào)用jQuery.ajax時(shí)提供的dataType參數(shù)。函數(shù)返回的值將由jQuery進(jìn)一步處理附鸽。
function(data, type){
//返回處理后的數(shù)據(jù)
return data;
}15.global:
要求為Boolean類型的參數(shù)脱拼,默認(rèn)為true。表示是否觸發(fā)全局ajax事件拒炎。設(shè)置為false將不會觸發(fā)全局ajax事件挪拟,ajaxStart或ajaxStop可用于控制各種ajax事件。16.ifModified:
要求為Boolean類型的參數(shù)击你,默認(rèn)為false玉组。僅在服務(wù)器數(shù)據(jù)改變時(shí)獲取新數(shù)據(jù)。服務(wù)器數(shù)據(jù)改變判斷的依據(jù)是Last-Modified頭信息丁侄。默認(rèn)值是false惯雳,即忽略頭信息。17.jsonp:
要求 為String類型的參數(shù)鸿摇,在一個(gè)jsonp請求中重寫回調(diào)函數(shù)的名字石景。該值用來替代在"callback=?"這種GET或POST請求中URL參數(shù)里 的"callback"部分,例如{jsonp:'onJsonPLoad'}會導(dǎo)致將"onJsonPLoad=?"傳給服務(wù)器拙吉。18.username:
要求為String類型的參數(shù)潮孽,用于響應(yīng)HTTP訪問認(rèn)證請求的用戶名。19.password:
要求為String類型的參數(shù)筷黔,用于響應(yīng)HTTP訪問認(rèn)證請求的密碼往史。20.processData:
要 求為Boolean類型的參數(shù),默認(rèn)為true佛舱。默認(rèn)情況下椎例,發(fā)送的數(shù)據(jù)將被轉(zhuǎn)換為對象(從技術(shù)角度來講并非字符串)以配合默認(rèn)內(nèi)容類 型"application/x-www-form-urlencoded"。如果要發(fā)送DOM樹信息或者其他不希望轉(zhuǎn)換的信息请祖,請?jiān)O(shè)置為false订歪。21.scriptCharset:
要求為String類型的參數(shù),只有當(dāng)請求時(shí)dataType為"jsonp"或者"script"肆捕,并且type是GET時(shí)才會用于強(qiáng)制修改字符集(charset)刷晋。通常在本地和遠(yuǎn)程的內(nèi)容編碼不同時(shí)使用。
ajax返回200進(jìn)入?yún)serror函數(shù)慎陵,通過url請求成功
在拿到后端接口進(jìn)行測試掏秩,通過瀏覽器url請求可以正常返回值,但是通過ajax調(diào)用時(shí)荆姆,響應(yīng)結(jié)果卻進(jìn)入到error蒙幻,響應(yīng)狀態(tài)碼200.
jQuery.ajax({
type: "POST",
async: true,
dataType: "json",
url: this.iurl + '/getCouponNums.action',
data: {venderIds: venderIds, random: Math.random()},
success: function (result) {
console.log("zslog 13.2 異步調(diào)用返回成功,result:"+result);
},
error: function (XMLHttpResponse, textStatus, errorThrown) {
console.log("1 異步調(diào)用返回失敗,XMLHttpResponse.readyState:"+XMLHttpResponse.readyState);
console.log("2 異步調(diào)用返回失敗,XMLHttpResponse.status:"+XMLHttpResponse.status);
console.log("3 異步調(diào)用返回失敗,textStatus:"+textStatus);
console.log("4 異步調(diào)用返回失敗,errorThrown:"+errorThrown);
}
});
第一個(gè)參數(shù)XMLHttpRequest.readyState: 狀態(tài)碼
0 - (未初始化)還沒有調(diào)用send()方法
1 - (載入)已調(diào)用send()方法,正在發(fā)送請求
2 - (載入完成)send()方法執(zhí)行完成胆筒,已經(jīng)接收到全部響應(yīng)內(nèi)容
3 - (交互)正在解析響應(yīng)內(nèi)容
4 - (完成)響應(yīng)內(nèi)容解析完成邮破,可以在客戶端調(diào)用了第二個(gè)參數(shù)XMLHttpRequest.status:
0XX:狀態(tài)未初始化
1xx-信息提示
這些狀態(tài)代碼表示臨時(shí)的響應(yīng)诈豌。客戶端在收到常規(guī)響應(yīng)之前抒和,應(yīng)準(zhǔn)備接收一個(gè)或多個(gè)1xx響應(yīng)矫渔。
2xx-成功
3xx-重定向
4xx-客戶端錯(cuò)誤
5xx-永久性否定的完成答復(fù)第三個(gè)參數(shù)textStatus:字符串類型的返回狀態(tài)
“timeout”(超時(shí)), “error”(錯(cuò)誤), “abort”(中止), “parsererror”(解析錯(cuò)誤),還有可能返回空值摧莽。第四個(gè)參數(shù)errorThrown:返回的錯(cuò)誤信息
表示服務(wù)器拋出返回的錯(cuò)誤信息庙洼,如果產(chǎn)生的是HTTP錯(cuò)誤,那么返回的信息就是HTTP狀態(tài)碼對應(yīng)的錯(cuò)誤信息镊辕,比如404的Not Found,500錯(cuò)誤的Internal Server Error油够。