title: 《鋒利的jQuery》九、$.ajax()的方法
date: 2017-08-22 21:25:20
tags: 鋒利的jQuery
| 參數(shù)名稱 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| accepts | Map | 內(nèi)容類(lèi)型發(fā)送請(qǐng)求頭，告訴服務(wù)器什么樣的響應(yīng)會(huì)接受返回。如果accepts設(shè)置需要修改，推薦在$.ajaxSetup()方法中做一次。 |
| async | Boolean | 默認(rèn)設(shè)置下（默認(rèn)為true），所有請(qǐng)求均為異步請(qǐng)求。如果需要發(fā)送同步請(qǐng)求，要將此選項(xiàng)設(shè)置為false，跨域不支持同步操作。 |
| beforeSend | Function | 發(fā)送請(qǐng)求前可修改XMLHttpRequest對(duì)象的函數(shù)，返回false可取消本次請(qǐng)求，function(XMLHttpRequest){ this是請(qǐng)求時(shí)傳遞的option參數(shù) }
|
| cache | Boolean | 默認(rèn)true，當(dāng)跨域時(shí)默認(rèn)為false，false時(shí)將不會(huì)從瀏覽器緩存中加載請(qǐng)求信息 |
| complete | Function | 請(qǐng)求完成后的回調(diào)函數(shù)，function(XMLHttpRequest, textStatus){ this是請(qǐng)求時(shí)傳遞的option參數(shù) }
|
| contents | Map | 以"{ 字符串: 正則表達(dá)式 }"配對(duì)的對(duì)象，用來(lái)確定jQuery將如何解析響應(yīng)，給定其內(nèi)容類(lèi)型。 |
| contentType | String | 當(dāng)發(fā)送信息至服務(wù)器時(shí)，內(nèi)容編碼類(lèi)型默認(rèn)為"application/x-www-form-urlencoded" |
| context | Object | 這個(gè)對(duì)象用于設(shè)置Ajax相關(guān)回調(diào)函數(shù)的上下文，也就是回調(diào)函數(shù)this的設(shè)置，默認(rèn)是傳遞的option參數(shù) |
| converters | Map | 一個(gè)數(shù)據(jù)類(lèi)型對(duì)數(shù)據(jù)類(lèi)型轉(zhuǎn)換器的對(duì)象。每個(gè)轉(zhuǎn)換器的值是一個(gè)函數(shù)，返回相應(yīng)的轉(zhuǎn)化值。 |
| crossDomain | 同域請(qǐng)求為false，跨域請(qǐng)求為true，如果要通過(guò)JSONP請(qǐng)求同域應(yīng)該設(shè)置為true。 | |
| data | Object或String | 發(fā)送到服務(wù)器的數(shù)據(jù) |
| dataFilter | Function | 給Ajax返回的原始數(shù)據(jù)進(jìn)行預(yù)處理的函數(shù)。function(data, type){ data是Ajax返回的原始數(shù)據(jù)，type是調(diào)用$.ajax時(shí)提供的dataType參數(shù)，最后需要return data }
|
| dataType | String | 預(yù)期服務(wù)器返回的數(shù)據(jù)類(lèi)型。如果不指定將根據(jù)MIME信息返回，可用類(lèi)型：xml、html、script、json、jsonp、text |
| error | Function | 請(qǐng)求失敗時(shí)被調(diào)用的函數(shù) function(XMLHttpRequest, textStatus, errorThrown){ this是請(qǐng)求時(shí)傳遞的option參數(shù) }
|
| global | Boolean | 是否觸發(fā)全局Ajax事件，默認(rèn)為true。 |
| Headers | Map | 一個(gè)額外的"{ 鍵: 值 }"對(duì)映射到請(qǐng)求一起發(fā)送，此設(shè)置被設(shè)置之前beforeSend函數(shù)被調(diào)用，因此，消息頭中的值設(shè)置可以在覆蓋beforeSend函數(shù)范圍內(nèi)的任何設(shè)置 |
| ifModified | Boolean | 默認(rèn):false 僅在服務(wù)器數(shù)據(jù)改變時(shí)獲取新數(shù)據(jù)，使用HTTP包Last-Modified頭信息判斷，也會(huì)檢查服務(wù)器指定的'etag'來(lái)確定數(shù)據(jù)沒(méi)有被修改過(guò) |
| isLocal | Boolean | 允許當(dāng)前環(huán)境被認(rèn)定為"本地"(比如系統(tǒng)文件)，即使jQuery默認(rèn)情況下不會(huì)承認(rèn)它。以下協(xié)議目前目前公認(rèn)為本地：file、*-extension、widget。如果要修改isLocal，建議在$.ajaxSetup()中做 |
| jsonp | String | 在一個(gè)jsonp請(qǐng)求中重寫(xiě)回調(diào)函數(shù)的名字，這個(gè)值用來(lái)替代在"callback=?"這種GET貨POST請(qǐng)求中URL參數(shù)里的"callback"部分，jsonp可是設(shè)置為false，為了阻止在URL中加入callback參數(shù)，但仍然要設(shè)置jsonpCallback參數(shù)。 |
| jsonpCallback | String，F(xiàn)unction | 為jsonp請(qǐng)求指定一個(gè)回調(diào)函數(shù)名，這個(gè)值將用來(lái)取代jQuery自動(dòng)生成的隨機(jī)函數(shù)名。 |
| mimeType | String | 一個(gè)mime類(lèi)型用來(lái)覆蓋XHR的MIME的類(lèi)型 |
| password | String | 用于響應(yīng)HTTP訪問(wèn)認(rèn)證請(qǐng)求的密碼 |
| processData | Boolean | 默認(rèn)為true，默認(rèn)情況下，發(fā)送的數(shù)據(jù)將被轉(zhuǎn)換為對(duì)象(實(shí)際上是非字符串)以配合默認(rèn)內(nèi)容類(lèi)型"application/x-www-form-urlencoded"。如果要發(fā)送DOM樹(shù)信息或者其他不希望轉(zhuǎn)換的信息，要設(shè)置為false。 |
| scriptCharset | String | 只有當(dāng)請(qǐng)求dataType為"jsonp"或者"script"，并且type時(shí)GET時(shí)才會(huì)用于強(qiáng)制修改字符集(charset)。通常在本地和遠(yuǎn)程的內(nèi)容編碼不同時(shí)使用。 |
| statusCode | Map | 一組數(shù)值的HTTP代碼和函數(shù)對(duì)象，當(dāng)響應(yīng)時(shí)調(diào)用了相應(yīng)的代碼，例如，如果響應(yīng)狀態(tài)是404，將觸發(fā)以下報(bào)警：statusCode: { 404: function(){ alert('page not found') } }
|
| success | Function | 請(qǐng)求成功后的回調(diào)函數(shù)，三個(gè)參數(shù)，返回的數(shù)據(jù)、描述狀態(tài)的字符串、jqXHR對(duì)象 |
| timeout | Number | 設(shè)置請(qǐng)求超時(shí)時(shí)間(毫秒)，此設(shè)置將覆蓋$.ajaxSetup方法的全局設(shè)置。 |
| traditional | Boolean | 如果想要用傳統(tǒng)的方法來(lái)序列化數(shù)據(jù)，那么就設(shè)置為true，可以參考jQuery.param方法。 |
| Type | String | 請(qǐng)求方式(POST或GET)，默認(rèn)為GET，跨域只能是GET方式。 |
| url | String | 發(fā)送請(qǐng)求的地址，默認(rèn)為當(dāng)前頁(yè)面 |
| username | String | 用于響應(yīng)HTTP訪問(wèn)認(rèn)證請(qǐng)求的用戶名 |
| xhr | Function | 回調(diào)創(chuàng)建XMLHttpRequest對(duì)象，當(dāng)可用時(shí)默認(rèn)為ActiveObject（IE）中，否則為XMLHttpRequest |
| xhrFields | Map | 一對(duì)"文件名-文件值"在本機(jī)設(shè)置XHR對(duì)象。例如，如果需要德華，可以用它來(lái)設(shè)置withCredentials為true的跨域請(qǐng)求 |
