jQuery ajax中的參數含義


所有options均可選,下面簡要說明每個option

1.async

默認為true,即請求為異步請求,這也是ajax存在的意義。但同時也可以將這個參數設置為false,實現同步請求。(同步請求會鎖定瀏覽器,直到這個請求結束后才可以執行其他操作)

2.bforeSend(XHR)

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

3.cache

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

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轉換后的值的方法。

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后的處理方法。

[javascript]  view plain copy
  1. $.ajax({   
  2.     statusCode: {   
  3.       404: function() {   
  4.            alert("page not found");   
  5.            }   
  6.       }   
  7. });  

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。

[javascript]  view plain copy
  1. $.ajax({   
  2.     url: a_cross_domain_url,   
  3.     xhrFields: {   
  4.     withCredentials: true   
  5.     }   
  6. });  

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

詳細文檔  jquery.ajax英文文檔

 

【轉載】http://blog.csdn.net/supersky07/article/details/7431721

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM