jQuery的ajax請求參數大全

jQuery的ajax請求參數大全

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

type:
要求爲String類型的參數,請求方式(post、get、delete等)默認爲get。ajax

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

$.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對象是唯一的參數。app

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

complete:
要求爲Function類型的參數,請求完成後調用的回調函數(請求成功或失敗時均調用)。參數:XMLHttpRequest對象和一個描述成功請求類型的字符串。異步

function(XMLHttpRequest, textStatus){

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

}

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

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);

                      }

         });

    });

});
相關文章
相關標籤/搜索