下面是Jquery中AJAX參數詳細列表:
參數名 |
類型 |
描述 |
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") 發送資訊至伺服器時內容編碼類別型。預設值適合大多數應用場合。 |
data |
Object, String |
發送到伺服器的資料。將自動轉換為請求字串格式。GET 請求中將附加在 URL 後。查看 processData 選項說明以禁止此自動轉換。必須為 Key/Value 格式。如果為數組,jQuery 將自動為不同值對應同一個名稱。如 {foo:["bar1", "bar2"]} 轉換為 '&foo=bar1&foo=bar2'。 |
dataType |
String |
預期伺服器返回的資料類型。如果不指定,jQuery 將自動根據 HTTP 包 MIME 資訊返回 responseXML 或 responseText,並作為回呼函數參數傳遞,可用值: "xml": 返回 XML 文檔,可用 jQuery 處理。 "html": 返回純文字 HTML 資訊;包含 script 元素。 "script": 返回純文字 JavaScript 代碼。不會自動緩衝結果。 "json": 返回 JSON 資料 。 "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 } |
代碼:
複製代碼 代碼如下:
$(document).ready(function() {
jQuery("#clearCac").click(function() {
jQuery.ajax({
url: "/Handle/Do.aspx",
type: "post",
data: { id: '0' },
dataType: "json",
success: function(msg) {
alert(msg);
},
error: function(XMLHttpRequest, textStatus, errorThrown) {
alert(XMLHttpRequest.status);
alert(XMLHttpRequest.readyState);
alert(textStatus);
},
complete: function(XMLHttpRequest, textStatus) {
this; // 調用本次AJAX請求時傳遞的options參數
}
});
});
});
一、error:function (XMLHttpRequest, textStatus, errorThrown)
{
}
(預設: 自動判斷 (xml 或 html)) 請求失敗時調用時間。參數有以下三個:XMLHttpRequest 對象、錯誤資訊、(可選)捕獲的錯誤對象。如果發生了錯誤,錯誤資訊(第二個參數)除了得到null之外,還可能是"timeout", "error", "notmodified" 和 "parsererror"。
textStatus:
"timeout", "error", "notmodified" 和 "parsererror"。
二、error事件返回的第一個參數XMLHttpRequest有一些有用的資訊:
XMLHttpRequest.readyState:
狀態代碼
0 - (未初始化)還沒有調用send()方法
1 - (載入)已調用send()方法,正在發送請求
2 - (載入完成)send()方法執行完成,已經接收到全部響應內容
3 - (互動)正在解析響應內容
4 - (完成)響應內容解析完成,可以在用戶端調用了
三、data:"{}", data為空白也一定要傳"{}";不然返回的是xml格式的。並提示parsererror.
四、parsererror的異常和Header 類型也有關係。及編碼header('Content-type: text/html; charset=utf8');
五、XMLHttpRequest.status:
1xx-資訊提示
這些狀態碼表示臨時的響應。用戶端在收到常規響應之前,應準備接收一個或多個1xx響應。
100-繼續。
101-切換協議。
2xx-成功
這類狀態碼表明伺服器成功地接受了用戶端請求。
200-確定。用戶端請求已成功。
201-已建立。
202-已接受。
203-非權威性資訊。
204-無內容。
205-重設內容。
206-部分內容。
3xx-重新導向
用戶端瀏覽器必須採取更多操作來實現請求。例如,瀏覽器可能不得不請求伺服器上的不同的頁面,或通過Proxy 伺服器重複該請求。
301-對象已永久移走,即永久重新導向。
302-對象已臨時移動。
304-未修改。
307-臨時重新導向。
4xx-用戶端錯誤
發生錯誤,用戶端似乎有問題。例如,用戶端請求不存在的頁面,用戶端未提供有效身分識別驗證資訊。400-錯誤的請求。
401-訪問被拒絕。IIS定義了許多不同的401錯誤,它們指明更為具體的錯誤原因。這些具體的錯誤碼在瀏覽器中顯示,但不在IIS日誌中顯示:
401.1-登入失敗。
401.2-伺服器配置導致登入失敗。
401.3-由於ACL對資源的限制而未獲得授權。
401.4-篩選器授權失敗。
401.5-ISAPI/CGI應用程式授權失敗。
401.7–訪問被Web伺服器上的URL授權策略拒絕。這個錯誤碼為IIS6.0所專用。
403-禁止訪問:IIS定義了許多不同的403錯誤,它們指明更為具體的錯誤原因:
403.1-執行訪問被禁止。
403.2-讀訪問被禁止。
403.3-寫訪問被禁止。
403.4-要求SSL。
403.5-要求SSL128。
403.6-IP地址被拒絕。
403.7-要求用戶端認證。
403.8-網站訪問被拒絕。
403.9-使用者數過多。
403.10-配置無效。
403.11-密碼更改。
403.12-拒絕訪問映射表。
403.13-用戶端認證被吊銷。
403.14-拒絕目錄列表。
403.15-超出用戶端訪問許可。
403.16-用戶端認證不受信任或無效。
403.17-用戶端認證已到期或尚未生效。
403.18-在當前的應用程式集區中不能執行所請求的URL。這個錯誤碼為IIS6.0所專用。
403.19-不能為這個應用程式集區中的用戶端執行CGI。這個錯誤碼為IIS6.0所專用。
403.20-Passport登入失敗。這個錯誤碼為IIS6.0所專用。
404-未找到。
404.0-(無)–沒有找到檔案或目錄。
404.1-無法在所請求的連接埠上訪問Web網站。
404.2-Web服務擴充鎖定策略阻止本請求。
404.3-MIME映射策略阻止本請求。
405-用來訪問本頁面的HTTP謂詞不被允許(方法不被允許)
406-用戶端瀏覽器不接受所請求頁面的MIME類型。
407-要求進行Proxy 驗證。
412-前提條件失敗。
413–請求實體太大。
414-請求URI太長。
415–不支援的媒體類型。
416–所請求的範圍無法滿足。
417–執行失敗。
423–鎖定的錯誤。
5xx-伺服器錯誤
伺服器由於遇到錯誤而不能完成該請求。
500-內部伺服器錯誤。
500.12-應用程式正忙於在Web伺服器上重新啟動。
500.13-Web伺服器太忙。
500.15-不允許直接請求Global.asa。
500.16–UNC授權憑據不正確。這個錯誤碼為IIS6.0所專用。
500.18–URL授權存放區不能開啟。這個錯誤碼為IIS6.0所專用。
500.100-內部ASP錯誤。
501-頁首值指定了未實現的配置。
502-Web伺服器用作網關或Proxy 伺服器時收到了無效響應。
502.1-CGI應用程式逾時。
502.2-CGI應用程式出錯。application.
503-服務不可用。這個錯誤碼為IIS6.0所專用。
504-網關逾時。
505-HTTP版本不受支援。
FTP
1xx-肯定的初步回覆
這些狀態碼指示一項操作已經成功開始,但用戶端希望在繼續操作新命令前得到另一個回覆。
110重新啟動標記回覆。
120服務已就緒,在nnn分鐘後開始。
125資料連線已開啟,正在開始傳輸。
150檔案狀態正常,準備開啟資料連線。
2xx-肯定的完成回覆
一項操作已經成功完成。用戶端可以執行新命令。200命令確定。
202未執行命令,網站上的命令過多。
211系統狀態,或系統協助回覆。
212目錄狀態。
213檔案狀態。
214協助訊息。
215NAME系統類別型,其中,NAME是AssignedNumbers文檔中所列的正式系統名稱。
220服務就緒,可以執行新使用者的請求。
221服務關閉控制串連。如果適當,請登出。
225資料連線開啟,沒有進行中的傳輸。
226關閉資料連線。請求的檔案操作已成功(例如,傳輸檔案或放棄檔案)。
227進入被動模式(h1,h2,h3,h4,p1,p2)。
230使用者已登入,繼續進行。
250請求的檔案操作正確,已完成。
257已建立“PATHNAME”。
3xx-肯定的中間回覆
該命令已成功,但伺服器需要更多來自用戶端的資訊以完成對請求的處理。331使用者名稱正確,要求輸入密碼。
332需要登入帳戶。
350請求的檔案操作正在等待進一步的資訊。
4xx-瞬態否定的完成回覆
該命令不成功,但錯誤是暫時的。如果用戶端重試命令,可能會執行成功。421服務不可用,正在關閉控制串連。如果服務確定它必須關閉,將向任何命令發送這一應答。
425無法開啟資料連線。
426Connectionclosed;transferaborted.
450未執行請求的檔案操作。檔案不可用(例如,檔案繁忙)。
451請求的操作異常終止:正在處理本地錯誤。
452未執行請求的操作。系統儲存空間不夠。
5xx-永久性否定的完成回覆
該命令不成功,錯誤是永久性的。如果用戶端重試命令,將再次出現同樣的錯誤。500語法錯誤,命令無法識別。這可能包括諸如命令列太長之類的錯誤。
501在參數中有語法錯誤。
502未執行命令。
503錯誤的命令序列。
504未執行該參數的命令。
530未登入。
532隱藏檔需要帳戶。
550未執行請求的操作。檔案不可用(例如,未找到檔案,沒有存取權限)。
551請求的操作異常終止:未知的頁面類型。
552請求的檔案操作異常終止:超出儲存分配(對於目前的目錄或資料集)。
553未執行請求的操作。不允許的檔案名稱。
常見的FTP狀態碼及其原因
150-FTP使用兩個連接埠:21用於發送命令,20用於發送資料。狀態碼150表示伺服器準備在連接埠20上開啟新串連,發送一些資料。
226-命令在連接埠20上開啟資料連線以執行操作,如傳輸檔案。該操作成功完成,資料連線已關閉。
230-用戶端發送正確的密碼後,顯示該狀態碼。它表示使用者已成功登入。
331-用戶端發送使用者名稱後,顯示該狀態碼。無論所提供的使用者名稱是否為系統中的有效帳戶,都將顯示該狀態碼。
426-命令開啟資料連線以執行操作,但該操作已被取消,資料連線已關閉。
530-該狀態碼表示使用者無法登入,因為使用者名稱和密碼組合無效。如果使用某個使用者帳戶登入,可能鍵入錯誤的使用者名稱或密碼,也可能選擇只允許匿名訪問。如果使用匿名帳戶登入,IIS的配置可能拒絕匿名訪問。
550-命令未被執行,因為指定的檔案不可用。例如,要GET的檔案並不存在,或試圖將檔案PUT到您沒有寫入許可權的目錄。