jQuery的ajax請求參數大全

jQuery的ajax請求參數大全

url:
要求爲String類型的參數，請求的地址。

type:
要求爲String類型的參數，請求方式（post、get、delete等）默認爲get。

timeout:
要求爲Number類型的參數，設置請求超時時間（毫秒）。此設置將覆蓋$.ajaxSetup()方法的全局設置。如：

$.ajaxSetup({
    //會被$.ajax中設置的timeout覆蓋掉
    timeout: 100000
});

async:
要求爲Boolean類型的參數，默認設置爲true，即全部請求均爲異步請求。若是須要發送同步請求，請將此選項設置爲false。注意，同步請求將鎖住瀏覽器，用戶其餘操做必須等待請求完成才能夠執行。

cache：
要求爲Boolean類型的參數，默認爲true；設置爲false將不會從瀏覽器緩存中加載請求信息。

data:
要求爲Object或String類型的參數，發送到服務器的數據。若是不是字符串，將自動轉換爲字符串格式。get請求中將附加在url後。防止這種自動轉換，能夠查看processData選項。對象必須爲key/value格式，例如{foo1:"bar1",foo2:"bar2"}轉換爲&foo1=bar1&foo2=bar2。若是是數組，JQuery將自動爲不一樣值對應同一個名稱。例如{foo:["bar1","bar2"]}轉換爲&foo=bar1&foo=bar2。

dataType:
要求爲String類型的參數，預期服務器返回的數據類型。若是不指定，JQuery將自動根據http包mime信息返回responseXML或responseText，並做爲回調函數參數傳遞。可用的類型以下：

xml：返回XML文檔，可用JQuery處理。

html：返回純文本HTML信息；包含的script標籤會在插入DOM時執行。

script：返回純文本JavaScript代碼。不會自動緩存結果。除非設置了cache參數。注意在遠程請求時（不在同一個域下），全部post請求都將轉爲get請求。

json：返回JSON數據。

jsonp：JSONP格式。使用SONP形式調用函數時，例如myurl?callback=?，JQuery將自動替換後一個「?」爲正確的函數名，以執行回調函數。

text：返回純文本字符串。

beforeSend：
要求爲Function類型的參數，發送請求前能夠修改XMLHttpRequest對象的函數，例如添加自定義HTTP頭。在beforeSend中若是返回false能夠取消本次ajax請求。XMLHttpRequest對象是唯一的參數。

function(XMLHttpRequest){
    this;   //調用本次ajax請求時傳遞的options參數
 }

complete：
要求爲Function類型的參數，請求完成後調用的回調函數（請求成功或失敗時均調用）。參數：XMLHttpRequest對象和一個描述成功請求類型的字符串。

function(XMLHttpRequest, textStatus){

   this;    //調用本次ajax請求時傳遞的options參數

}

success：
要求爲Function類型的參數，請求成功後調用的回調函數，有兩個參數。(1)由服務器返回，並根據dataType參數進行處理後的數據。(2)描述狀態的字符串。

function(data, textStatus){

//data多是xmlDoc、jsonObj、html、text等等

  this;  //調用本次ajax請求時傳遞的options參數
}

error：
要求爲Function類型的參數，請求失敗時被調用的函數。該函數有3個參數，即XMLHttpRequest對象、錯誤信息、捕獲的錯誤對象(可選)。ajax事件函數以下：

function(XMLHttpRequest, textStatus, errorThrown){

 //一般狀況下textStatus和errorThrown只有其中一個包含信息

 this;   //調用本次ajax請求時傳遞的options參數

}

contentType：
要求爲String類型的參數，當發送信息至服務器時，內容編碼類型默認爲"application/x-www-form-urlencoded"。該默認值適合大多數應用場合。

dataFilter：
要求爲Function類型的參數，給Ajax返回的原始數據進行預處理的函數。提供data和type兩個參數。data是Ajax返回的原始數據，type是調用jQuery.ajax時提供的dataType參數。函數返回的值將由jQuery進一步處理。

function(data, type){

//返回處理後的數據

return data;

 }

global：
要求爲Boolean類型的參數，默認爲true。表示是否觸發全局ajax事件。設置爲false將不會觸發全局
ajax事件，ajaxStart或ajaxStop可用於控制各類ajax事件。

ifModified：
要求爲Boolean類型的參數，默認爲false。僅在服務器數據改變時獲取新數據。服務器數據改變判斷的依據是Last-Modified頭信息。默認值是false，即忽略頭信息。

jsonp：
要求爲String類型的參數，在一個jsonp請求中重寫回調函數的名字。該值用來替代在"callback=?"這種GET或POST請求中URL參數裏的"callback"部分，例如{jsonp:'onJsonPLoad'}會致使將"onJsonPLoad=?"傳給服務器。

username：
要求爲String類型的參數，用於響應HTTP訪問認證請求的用戶名。

password：
要求爲String類型的參數，用於響應HTTP訪問認證請求的密碼。

processData：
要求爲Boolean類型的參數，默認爲true。默認狀況下，發送的數據將被轉換爲對象（從技術角度來說並不是字符串）以配合默認內容類型"application/x-www-form-urlencoded"。若是要發送DOM樹信息或者其餘不但願轉換的信息，請設置爲false。

scriptCharset：
要求爲String類型的參數，只有當請求時dataType爲"jsonp"或者"script"，而且type是GET時纔會用於強制修改字符集(charset)。一般在本地和遠程的內容編碼不一樣時使用。

案例代碼：

$(function(){

    $('#send').click(function(){

         $.ajax({

             type: "GET",

             url: "test.json",

             data: {username:$("#username").val(), content:$("#content").val()},

             dataType: "json",

             success: function(data){

                         $('#resText').empty();   //清空resText裏面的全部內容

                         var html = ''; 

                         $.each(data, function(commentIndex, comment){

                               html += '<div class="comment"><h6>' + comment['username']

                                         + ':</h6><p class="para"' + comment['content']

                                         + '</p></div>';

                         });

                         $('#resText').html(html);

                      }

         });

    });

});