jQuery ajax參數含義

全部options都可選,下面簡要說明每一個optionhtml

1.async

默認爲true,即請求爲異步請求,這也是ajax存在的意義。但同時也能夠將這個參數設置爲false,實現同步請求。(同步請求會鎖定瀏覽器,直到這個請求結束後才能夠執行其餘操做)jquery

2.bforeSend(XHR)

這個方法是用來在發送請求前修改XMLHttpRequest對象的,若修改失敗返回false,則取消這次ajax請求;ajax

3.cache

默認爲true,設置爲false即不緩存。(當datatype爲script或jasonp時默認爲fasle)json

4.complete(jqXHR,textStatus)

請求完成後的回調函數,不管成功與否。textStatus爲一個描述請求類型的字符串,它能夠有如下值success,notmodified,error,timeout,abort,parsererror。跨域

5.contents

jQuery1.5添加。一個字符串或常規表達式的map,用來肯定用何種方式處理jQuery的response。瀏覽器

6.contentType

它是發送到服務器的額數據的內容編碼類型,它的默認值是"appliction/x-www-form-urlencoded"。傳遞的服務器的數據一般以UTF-8編碼。緩存

7.context

用來設置ajax回調函數的上下文。讓回調函數中的this指向這個對象。服務器

8.converters

jQuery1.5添加。一組數據類型到數據類型的轉換。每個轉換值都是一個返回了response轉換後的值的方法。app

9.crossDomain

false表示同一域請求,true表示跨域請求。它可使服務器端重定向到另一個域。異步

10.data

發送到服務器的數據。必須爲key/value格式。且自動轉換爲query string,get請求會將字符串附加在url後。

11.dataFilter(data,type)

將ajax的返回值進行預處理的函數,data爲返回值,teype爲傳遞的datatype參數。

12.dataType

預期服務器返回的數據類型。若沒指定,則自動根據http包中的mime信息來判斷。可用值爲xml,html,script,json,jsonp,text。

13.error(jqXHR,textStatus,errorThrown)

當請求失敗時調用這個方法。textStatus爲錯誤信息,可用值爲error,timeout,abort,parsererror。errorThrown爲可選的要捕獲的異常對象。

14.global

默認爲true,觸發全局ajax事件。設置爲false能夠用來不觸發。能夠用來控制不一樣的ajax事件。

15.headers

jQuery1.5添加。一個用於一塊兒進行請求的額外的key/value對的map。這項須要在beforeSend方法被調用前設置,由於headers中的任意值都有肯那個在beforeSend方法中被覆蓋。

16.ifModified

默認爲false,僅在服務器數據改變時獲取數據,使用http包中的Last-Modified頭信息判斷。

17.isLocal

jQuery1.5.1添加。容許將當前環境識別爲local,jquery默認是不會識別的。file,*-extension 和widget協議能夠被識別爲local。若是isLocal須要被修改,推薦使用$.ajaxSetup()方法。

18.jsonp

重啓jsonp請求中的回調函數名。這個值用來代替在「callback=?」這種請求中url參數裏的callback部分。

19.jsonpCallback

爲jsonp請求指定一個回調函數名。jquery會自動生成隨機函數名,用這個值能夠修改此名。

20.mimetype

jQuery1.5.1添加。能夠用來覆蓋XHR中的mimetype。

21.password

用於響應http訪問認證請求的密碼。

22.processData

默認爲true。能夠將data傳遞的數據類型進行修改用來匹配contenttype的類型。false則不修改。

23.scriptCharset

只有當請求爲jsonp或script,而且type爲get時纔會用於強制修改charset。

24.statusCode

jQuery1.5添加。用來定義http的返回碼對應的處理函數。下面的例子定義了返回404後的處理方法。

25.success(data,textStatus,jqXHR)

請求成功後的回調函數。參數由服務器返回,並會根據datatype參數進行參數處理。

26.timeout

設置請求超時時間,毫秒爲單位。此設置會覆蓋全局設置,即全部ajax請求共享同一個超時時間。

27.traditional

設置爲true,用傳統的方式來序列化數據。

28.type

請求方式,get或post或put或delete。默認爲get。put和delte不是獲得全部的瀏覽器支持。

29.url

發送請求的地址。爲空表示當前頁。

30.username

用於響應http訪問認證請求的用戶名。同password配對。

31.xhr

默認在ie下是ActiveXObject而其餘瀏覽器是XMLHttpRequest。用於重寫或提供一個加強的XMLHttpRequest對象。

32.xhrFields

jQuery1.5.1添加。它能夠添加到原生xhr對象上的key/value對。舉個例子,你能夠經過它來設置跨域的withCredentials爲true。

在jQuery1.5中,withCredentials這個屬性不在原生的xhr中,因此這個請求會被忽略到。若要測試這個例子,須要使用jQuery1.5.1。

相關文章
相關標籤/搜索