jquery ajax 方法及各參數詳解

標籤：ons   jsonp   支援   add   javascrip   非同步   轉換   ati   www   

jquery ajax 方法及各參數詳解

1.$.ajax() 只有一個參數：參數 key/value 對象，包含各配置及回呼函數資訊。

參數列表：

參數名	類型	描述
url	String	(預設: 當前頁地址) 發送請求的地址。
type	String	(預設: "GET") 請求方式 ("POST" 或 "GET")， 預設為 "GET"。注意：其它 HTTP 要求方法，如 PUT 和 DELETE 也可以使用，但僅部分瀏覽器支援。
timeout	Number	佈建要求逾時時間（毫秒）。此設定將覆蓋全域設定。
async	Boolean	(預設: true) 預設設定下，所有請求均為非同步請求。如果需要發送同步請求，請將此選項設定為 false。注意，同步請求將鎖住瀏覽器，使用者其它操作必須等待請求完成才可以執行。
beforeSend	Function	發送請求前可修改 XMLHttpRequest 對象的函數，如添加自訂 HTTP 頭。XMLHttpRequest 對象是唯一的參數。 function (XMLHttpRequest) { this; // the options for this ajax request }
cache	Boolean	(預設: true) jQuery 1.2 新功能，設定為 false 將不會從瀏覽器緩衝中載入請求資訊。
complete	Function	請求完成後回呼函數 (請求成功或失敗時均調用)。參數： XMLHttpRequest 對象，成功資訊字串。 function (XMLHttpRequest, textStatus) { this; // the options for this ajax request }
contentType	String	(預設: "application/x-www-form-urlencoded") 發送資訊至伺服器時內容編碼類別型。預設值適合大多數應用場合。告訴伺服器從瀏覽器提交過來的資料格式。 例如：我們提交資料時假如使用了 JSON2.js 中方法 JSON.stringify(obj) 格式化為json字串後，再預設提交就會報錯。這個時候就需要指定提交的內容格式為："application/json"。
data	Object, String	發送到伺服器的資料。 若data資料類型為JavaScript對象或數組，Jquery在提交之前自動調用JQuery.param()方法把要發送的資料編碼成為"application/x-www-form-urlencoded"格式的資料（即 name=value&name1=value1）；JavaScript對象必須為 Key/Value 格式；如果為數組，jQuery 將自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 ‘&foo=bar1&foo=bar2‘； 若data資料類型為String類型，則直接預設該資料已經按照"application/x-www-form-urlencoded"格式編碼完成，不再轉換。 processData選項可以控制是否進行轉換。該選項預設為true。
dataType	String	預期伺服器返回的資料類型。設定HttpHeader中“Accept”域的內容，告訴伺服器瀏覽器可以想要返回的資料格式類型，同時JQuery也會根據該類型對返回的資料進行處理。如果不指定，jQuery 將自動根據 HTTP 包 MIME 資訊返回 responseXML 或 responseText，並作為回呼函數參數傳遞，可用值: "xml": 返回 XML 文檔，可用 jQuery 處理。 "html": 返回純文字 HTML 資訊；包含 script 元素。 "script": 返回純文字 JavaScript 代碼。不會自動緩衝結果。 "json": 返回 JSON 資料 。JQuery將返回的字串格式資料自動轉化為Javascript對象，便於直接使用obj.property格式訪問。若沒有指定該選項，即使返回的是JSON格式的字串，JQuery也不會自動轉換。 "jsonp": JSONP 格式。使用 JSONP 形式調用函數時，如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數名，以執行回呼函數。
error	Function	(預設: 自動判斷 (xml 或 html)) 請求失敗時將調用此方法。這個方法有三個參數：XMLHttpRequest 對象，錯誤資訊，（可能）捕獲的錯誤對象。 function (XMLHttpRequest, textStatus, errorThrown) { // 通常情況下textStatus和errorThown只有其中一個有值 this; // the options for this ajax request }
global	Boolean	(預設: true) 是否觸發全域 AJAX 事件。設定為 false 將不會觸發全域 AJAX 事件，如 ajaxStart 或 ajaxStop 。可用於控制不同的Ajax事件
ifModified	Boolean	(預設: false) 僅在伺服器資料改變時擷取新資料。使用 HTTP 包 Last-Modified 頭資訊判斷。
processData	Boolean	(預設: true) 預設情況下，發送的資料將被轉換為對象(技術上講並非字串) 以配合預設內容類型 "application/x-www-form-urlencoded"。如果要發送 DOM 樹資訊或其它不希望轉換的資訊，請設定為 false。
success	Function	請求成功後回呼函數。這個方法有兩個參數：伺服器返回資料，返回狀態 function (data, textStatus) { // data could be xmlDoc, jsonObj, html, text, etc... this; // the options for this ajax request }

2. jQuery.get(url, [data], [callback], [type])：使用GET方式來進行非同步請求.

參數：
url (String) : 發送請求的URL地址.
data (Map) : (可選) 要發送給伺服器的資料，以 Key/value 的索引值對形式表示。
callback (Function) : (可選) 載入成功時回呼函數(只有當Response的返回狀態是success才是調用該方法)。
type (String) : (可選)官方的說明是：Type of data to be sent。其實應該為用戶端請求的類型(JSON,XML,等等)

3. jQuery.post( url, [data], [callback], [type] ) ：使用POST方式來進行非同步請求

參數：
url (String) : 發送請求的URL地址.
data (Map) : (可選) 要發送給伺服器的資料，以 Key/value 的索引值對形式表示。
callback (Function) : (可選) 載入成功時回呼函數(只有當Response的返回狀態是success才是調用該方法)。
type (String) : (可選)官方的說明是：Type of data to be sent。其實應該為用戶端請求的類型(JSON,XML,等等)

jquery ajax 方法及各參數詳解