參數名 |
類型 |
描述 |
url |
String |
(默認:當前頁地址) 發送請求的地址。 |
type |
String |
(默認: "GET")請求方式 ("POST"或 "GET"),默認爲 "GET"。注意:其它 HTTP 請求方法,如 PUT和 Delete 也可以使用,但僅部分瀏覽器支持。 |
timeout |
Number |
設置請求超時時間(毫秒)。此設置將覆蓋全局設置。 |
async |
Boolean |
(默認: true)默認設置下,所有請求均爲異步請求。如果需要發送同步請求,請將此選項設置爲 false。注意,同步請求將鎖住瀏覽器,用戶其它操作必須等待請求完成纔可以執行。 |
beforeSend |
Function |
發送請求前可修改 XMLHttpRequest對象的函數,如添加自定義 HTTP頭。XMLHttpRequest對象是唯一的參數。 function (XMLHttpRequest) { |
cache |
Boolean |
(默認: true) jQuery 1.2新功能,設置爲 false將不會從瀏覽器緩存中加載請求信息。 |
complete |
Function |
請求完成後回調函數 (請求成功或失敗時均調用)。參數: XMLHttpRequest對象,成功信息字符串。 function (XMLHttpRequest, textStatus) { |
contentType |
String |
(默認: "application/x-www-form-urlencoded")發送信息至服務器時內容編碼類型。默認值適合大多數應用場合。 |
data |
Object, |
發送到服務器的數據。將自動轉換爲請求字符串格式。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) { |
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) { |