1 $.ajax({ 2 3 //參數 4 5 })
本篇內容來自於某位博主,只是根據是否常用修改了一下順序,后續來看發現忘記將該博文鏈接加上,現在忘記具體是哪位博主的博文了,感覺萬分抱歉
可以參考以下: 陳志瀮 : https://www.cnblogs.com/chenzhiling/p/8572010.html
草漾 : https://www.cnblogs.com/wuchenfei/p/9820958.html
nd : https://www.cnblogs.com/tylerdonet/p/3520862.html
應用實例:
1 var stream = { 2 id: $("#streamId").val(), 3 title: "" == $("#stream_title").val().trim() ? null : $("#stream_title").val().trim(), 4 disabled: !$("#stream_disabled").prop("checked"), 5 topoIds: $("#topoIds").val(), 6 streamrules: streamrule_datas, 7 }; 8 9 $.ajax({ 10 11 url: APP_NAME + "streams/saveStreamrules", 12 type: "post", 13 contentType: "application/json; charset=utf-8", 14 data: JSON.stringify(stream), //將json對象轉為json字符串 15 dataType: "json", //表示接受的數據為json類型 16 success: function (data) { 17 // 請求成功后執行的代碼 18 if (data.success) { 19 20 } else { 21 22 } 23 }, 24 error: function(){ 25 26 } 27 });
其中紅色的是常用的參數,整理到了前面
1.url:
要求為String類型的參數,(默認為當前頁地址)發送請求的地址。
就是在此發送需求到對應的后台去處理,后台根據這個url來區別不同的請求。
2.type:
要求為String類型的參數,請求方式(post或get)默認為get。注意其他http請求方法,例如put和delete也可以使用,但僅部分瀏覽器支持。
post:瀏覽器把各表單字段元素及其數據作為HTTP消息的實體內容發送給Web服務器,數據量要比使用GET方式傳送的數據量大的多,安全。
get:get方式可傳送簡單數據,有大小限制,數據追加到url中發送(http的header傳送),url可以被客戶端緩存,從瀏覽器的歷史記錄中得到客戶數據,不安全。
3.async:
要求為Boolean類型的參數,默認設置為true,所有請求均為異步請求。如果需要發送同步請求,請將此選項設置為false。注意,同步請求將鎖住瀏覽器,用戶其他操作必須等待請求完成才可以執行。
這里就會經常發生問題,就是異步了,所以有時候你會不小心,在請求還沒成功,你就以為你成功了,然后再干其他事,就容易出問題,所以,一般要在success回調函數里面做一些事。
4.data:
發送到服務器的數據,要求為Object或String類型的參數。如果已經不是字符串,將自動轉換為字符串格式。get請求中將附加在url后。防止這種自動轉換,可以查看 processData選項。對象必須為key/value格式。如果是數組,JQuery將自動為不同值對應同一個名稱。
// 對象必須為key/value格式。例如: { foo1:"bar1", foo2:"bar2" } =>&foo1=bar1&foo2=bar2。 // 如果是數組,JQuery將自動為不同值對應同一個名稱。例如: { foo:["bar1","bar2"] } => &foo=bar1&foo=bar2。
上面的例子中,就是把一個javascript對象給變成json然后傳到后台去處理
5.dataType:
要求為String類型的參數,預期服務器返回的數據類型。如果不指定,JQuery將自動根據http包mime信息返回responseXML或responseText,並作為回調函數參數傳遞。可用的類型如下:
xml:返回XML文檔,可用JQuery處理。 html:返回純文本HTML信息;包含的script標簽會在插入DOM時執行。 script:返回純文本JavaScript代碼。不會自動緩存結果。除非設置了cache參數。注意在遠程請求時(不在同一個域下),所有post請求都將轉為get請求。 json:返回JSON數據。起碼我見到都是返回json類型。其他的沒見用過。后台可以處理完之后返回一個bean的對象,然后將對象轉換成json字符串形式的對象,就跟之最上面的例子中的stream對象一樣,可以方便的操作各個屬性,然后在前台操作的時候就灰常的方便。。。一句話概括:如果指定為json類型,則會把獲取到的數據作為一個JavaScript對象來解析,並且把構建好的對象作為結果返回。 jsonp:JSONP格式。使用SONP形式調用函數時,例如myurl?callback=?,JQuery將自動替換后一個“?”為正確的函數名,以執行回調函數。 text:返回純文本字符串。
6.success:
要求為Function類型的參數,請求成功后調用的回調函數,有兩個參數。
(1)由服務器返回,並根據dataType參數進行處理后的數據。
(2)描述狀態的字符串。
1 function(data, textStatus){ 2 //data可能是xmlDoc、jsonObj、html、text等等 3 this; //調用本次ajax請求時傳遞的options參數 4 }
例子中的data就是后台處理之后,返回的一個javascript對象,里面包含前台需要的各種信息,需要什么塞什么。
一般都是只用第一個參數,第二個基本沒見過。
這個才是灰常常用的一個參數。
7.error:
要求為Function類型的參數,請求失敗時被調用的函數。該函數有3個參數,即XMLHttpRequest對象、錯誤信息、捕獲的錯誤對象(可選)。ajax事件函數如下:
1 function(XMLHttpRequest, textStatus, errorThrown){ 2 //通常情況下textStatus和errorThrown只有其中一個包含信息 3 this; //調用本次ajax請求時傳遞的options參數 4 }
8.contentType:
要求為String類型的參數,當發送信息至服務器時,內容編碼類型默認為"application/x-www-form-urlencoded"。該默認值適合大多數應用場合。
multipart/form-data:有時候也會這個,上傳下載可能會用到。
contentType: "application/json; charset=utf-8",
我想現在json這么簡單易用,估計一般這個類型也很常用吧。
9.timeout:
要求為Number類型的參數,設置請求超時時間(毫秒)。此設置將覆蓋$.ajaxSetup()方法的全局設置。
10.cache:
要求為Boolean類型的參數,默認為true(當dataType為script時,默認為false),設置為false將不會從瀏覽器緩存中加載請求信息。
11.beforeSend:
要求為Function類型的參數,發送請求前可以修改XMLHttpRequest對象的函數,例如添加自定義HTTP頭。在beforeSend中如果返回false可以取消本次ajax請求。XMLHttpRequest對象是惟一的參數。
1 function(XMLHttpRequest){ 2 this; //調用本次ajax請求時傳遞的options參數 4 }
12.complete:
要求為Function類型的參數,請求完成后調用的回調函數(請求成功或失敗時均調用)。參數:XMLHttpRequest對象和一個描述成功請求類型的字符串。
1 function(XMLHttpRequest, textStatus){ 2 this; //調用本次ajax請求時傳遞的options參數 3 }
13.dataFilter:
要求為Function類型的參數,給Ajax返回的原始數據進行預處理的函數。提供data和type兩個參數。data是Ajax返回的原始數據,type是調用jQuery.ajax時提供的dataType參數。函數返回的值將由jQuery進一步處理。
1 function(data, type){ 2 //返回處理后的數據 3 return data; 4 }
14.global:
要求為Boolean類型的參數,默認為true。表示是否觸發全局ajax事件。設置為false將不會觸發全局ajax事件,ajaxStart或ajaxStop可用於控制各種ajax事件。
15.ifModified:
要求為Boolean類型的參數,默認為false。僅在服務器數據改變時獲取新數據。服務器數據改變判斷的依據是Last-Modified頭信息。默認值是false,即忽略頭信息。
16.jsonp:
要求為String類型的參數,在一個jsonp請求中重寫回調函數的名字。該值用來替代在"callback=?"這種GET或POST請求中URL參數里的"callback"部分,例如{jsonp:'onJsonPLoad'}會導致將"onJsonPLoad=?"傳給服務器。
17.username:
要求為String類型的參數,用於響應HTTP訪問認證請求的用戶名。
18.password:
要求為String類型的參數,用於響應HTTP訪問認證請求的密碼。
19.processData:
要求為Boolean類型的參數,默認為true。默認情況下,發送的數據將被轉換為對象(從技術角度來講並非字符串)以配合默認內容類型"application/x-www-form-urlencoded"。如果要發送DOM樹信息或者其他不希望轉換的信息,請設置為false。
20.scriptCharset:
要求為String類型的參數,只有當請求時dataType為"jsonp"或者"script",並且type是GET時才會用於強制修改字符集(charset)。通常在本地和遠程的內容編碼不同時使用。
1 $(function(){ 2 $('#send').click(function(){ 3 $.ajax({ 4 type: "GET", 5 url: "test.json", 6 data: {username:$("#username").val(), content:$("#content").val()}, 7 dataType: "json", 8 success: function(data){ 9 console.log(data); 10 } 11 }); 12 }); 13 });