jQuery $.ajax() 方法概述

url,[settings]ObjectV1.5

url:一個用來包含發(fā)送請求的URL字符串。

settings:AJAX 請求設(shè)置。所有選項(xiàng)都是可選的。

acceptsMap

默認(rèn)： 取決于數(shù)據(jù)類型。

內(nèi)容類型發(fā)送請求頭，告訴服務(wù)器什么樣的響應(yīng)會接受返回。如果accepts設(shè)置需要修改，推薦在$.ajaxSetup()方法中做一次。

asyncBoolean

(默認(rèn): true) 默認(rèn)設(shè)置下，所有請求均為異步請求。如果需要發(fā)送同步請求，請將此選項(xiàng)設(shè)置為 false。注意，同步請求將鎖住瀏覽器，用戶其它操作必須等待請求完成才可以執(zhí)行。

beforeSend(XHR)Function

發(fā)送請求前可修改 XMLHttpRequest 對象的函數(shù)，如添加自定義 HTTP 頭。XMLHttpRequest 對象是唯一的參數(shù)。這是一個 Ajax 事件。如果返回false可以取消本次ajax請求。

function (XMLHttpRequest) {
    this; // 調(diào)用本次AJAX請求時傳遞的options參數(shù)
}

cacheBoolean

(默認(rèn): true,dataType為script和jsonp時默認(rèn)為false) jQuery 1.2 新功能，設(shè)置為 false 將不緩存此頁面。

complete(XHR, TS)Function

請求完成后回調(diào)函數(shù) (請求成功或失敗之后均調(diào)用)。參數(shù)： XMLHttpRequest 對象和一個描述成功請求類型的字符串。 Ajax 事件。

function (XMLHttpRequest, textStatus) {
    this; // 調(diào)用本次AJAX請求時傳遞的options參數(shù)
}

contentsMapV1.5

一個以"{字符串:正則表達(dá)式}"配對的對象，用來確定jQuery將如何解析響應(yīng)，給定其內(nèi)容類型。

contentTypeString

(默認(rèn): "application/x-www-form-urlencoded") 發(fā)送信息至服務(wù)器時內(nèi)容編碼類型。默認(rèn)值適合大多數(shù)情況。如果你明確地傳遞了一個content-type給 $.ajax() 那么他必定會發(fā)送給服務(wù)器（即使沒有數(shù)據(jù)要發(fā)送）

contextObject

這個對象用于設(shè)置Ajax相關(guān)回調(diào)函數(shù)的上下文。也就是說，讓回調(diào)函數(shù)內(nèi)this指向這個對象（如果不設(shè)定這個參數(shù)，那么this就指向調(diào)用本次AJAX請求時傳遞的options參數(shù)）。比如指定一個DOM元素作為context參數(shù)，這樣就設(shè)置了success回調(diào)函數(shù)的上下文為這個DOM元素。就像這樣：

$.ajax({ url: "test.html", context: document.body, success: function(){
    $(this).addClass("done");
}});

convertersmapV1.5

默認(rèn)： {"* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML}

一個數(shù)據(jù)類型對數(shù)據(jù)類型轉(zhuǎn)換器的對象。每個轉(zhuǎn)換器的值是一個函數(shù)，返回響應(yīng)的轉(zhuǎn)化值

crossDomainmapV1.5

默認(rèn)： 同域請求為false

跨域請求為true如果你想強(qiáng)制跨域請求（如JSONP形式）同一域，設(shè)置crossDomain為true。這使得例如，服務(wù)器端重定向到另一個域

dataObject,String

發(fā)送到服務(wù)器的數(shù)據(jù)。將自動轉(zhuǎn)換為請求字符串格式。GET 請求中將附加在 URL 后。查看 processData 選項(xiàng)說明以禁止此自動轉(zhuǎn)換。必須為 Key/Value 格式。如果為數(shù)組，jQuery 將自動為不同值對應(yīng)同一個名稱。如 {foo:["bar1", "bar2"]} 轉(zhuǎn)換為 "&foo=bar1&foo=bar2"。

dataFilterFunction

給Ajax返回的原始數(shù)據(jù)的進(jìn)行預(yù)處理的函數(shù)。提供data和type兩個參數(shù)：data是Ajax返回的原始數(shù)據(jù)，type是調(diào)用jQuery.ajax時提供的dataType參數(shù)。函數(shù)返回的值將由jQuery進(jìn)一步處理。

function (data, type) {
    // 對Ajax返回的原始數(shù)據(jù)進(jìn)行預(yù)處理
    return data  // 返回處理后的數(shù)據(jù)
}

dataTypeString

預(yù)期服務(wù)器返回的數(shù)據(jù)類型。如果不指定，jQuery 將自動根據(jù) HTTP 包 MIME 信息來智能判斷，比如XML MIME類型就被識別為XML。在1.4中，JSON就會生成一個JavaScript對象，而script則會執(zhí)行這個腳本。隨后服務(wù)器端返回的數(shù)據(jù)會根據(jù)這個值解析后，傳遞給回調(diào)函數(shù)。可用值:

"xml": 返回 XML 文檔，可用 jQuery 處理。

"html": 返回純文本 HTML 信息；包含的script標(biāo)簽會在插入dom時執(zhí)行。

"script": 返回純文本 JavaScript 代碼。不會自動緩存結(jié)果。除非設(shè)置了"cache"參數(shù)。'''注意：'''在遠(yuǎn)程請求時(不在同一個域下)，所有POST請求都將轉(zhuǎn)為GET請求。(因?yàn)閷⑹褂肈OM的script標(biāo)簽來加載)

"json": 返回 JSON 數(shù)據(jù) 。

"jsonp": JSONP 格式。使用 JSONP 形式調(diào)用函數(shù)時，如 "myurl?callback=?" jQuery 將自動替換 ? 為正確的函數(shù)名，以執(zhí)行回調(diào)函數(shù)。

"text": 返回純文本字符串

errorFunction

(默認(rèn): 自動判斷 (xml 或 html)) 請求失敗時調(diào)用此函數(shù)。有以下三個參數(shù)：XMLHttpRequest 對象、錯誤信息、（可選）捕獲的異常對象。如果發(fā)生了錯誤，錯誤信息（第二個參數(shù)）除了得到null之外，還可能是"timeout", "error", "notmodified" 和 "parsererror"。Ajax 事件。

function (XMLHttpRequest, textStatus, errorThrown) {
    // 通常 textStatus 和 errorThrown 之中
    // 只有一個會包含信息
    this; // 調(diào)用本次AJAX請求時傳遞的options參數(shù)
}

globalBoolean

(默認(rèn): true) 是否觸發(fā)全局 AJAX 事件。設(shè)置為 false 將不會觸發(fā)全局 AJAX 事件，如 ajaxStart 或 ajaxStop 可用于控制不同的 Ajax 事件。

headersmapV1.5

Default: {}

一個額外的"{鍵:值}"對映射到請求一起發(fā)送。此設(shè)置被設(shè)置之前beforeSend函數(shù)被調(diào)用;因此，消息頭中的值設(shè)置可以在覆蓋beforeSend函數(shù)范圍內(nèi)的任何設(shè)置。

ifModifiedBoolean

(默認(rèn): false) 僅在服務(wù)器數(shù)據(jù)改變時獲取新數(shù)據(jù)。使用 HTTP 包 Last-Modified 頭信息判斷。在jQuery 1.4中，他也會檢查服務(wù)器指定的'etag'來確定數(shù)據(jù)沒有被修改過。

isLocalmapV1.5.1

默認(rèn): 取決于當(dāng)前的位置協(xié)議

允許當(dāng)前環(huán)境被認(rèn)定為“本地”，（如文件系統(tǒng)），即使jQuery默認(rèn)情況下不會承認(rèn)它。以下協(xié)議目前公認(rèn)為本地：file, *-extension, and widget。如果isLocal設(shè)置需要修改，建議在$.ajaxSetup()方法中這樣做一次。

jsonpString

在一個jsonp請求中重寫回調(diào)函數(shù)的名字。這個值用來替代在"callback=?"這種GET或POST請求中URL參數(shù)里的"callback"部分，比如{jsonp:'onJsonPLoad'}會導(dǎo)致將"onJsonPLoad=?"傳給服務(wù)器。

jsonpCallbackString

為jsonp請求指定一個回調(diào)函數(shù)名。這個值將用來取代jQuery自動生成的隨機(jī)函數(shù)名。這主要用來讓jQuery生成度獨(dú)特的函數(shù)名，這樣管理請求更容易，也能方便地提供回調(diào)函數(shù)和錯誤處理。你也可以在想讓瀏覽器緩存GET請求的時候，指定這個回調(diào)函數(shù)名。

mimeTypeStringV1.5.1

一個mime類型用來覆蓋XHR的 MIME類型。

passwordString

用于響應(yīng)HTTP訪問認(rèn)證請求的密碼

processDataBoolean

(默認(rèn): true) 默認(rèn)情況下，通過data選項(xiàng)傳遞進(jìn)來的數(shù)據(jù)，如果是一個對象(技術(shù)上講只要不是字符串)，都會處理轉(zhuǎn)化成一個查詢字符串，以配合默認(rèn)內(nèi)容類型 "application/x-www-form-urlencoded"。如果要發(fā)送 DOM 樹信息或其它不希望轉(zhuǎn)換的信息，請設(shè)置為 false。

scriptCharsetString

只有當(dāng)請求時dataType為"jsonp"或"script"，并且type是"GET"才會用于強(qiáng)制修改charset。通常只在本地和遠(yuǎn)程的內(nèi)容編碼不同時使用。

statusCodemapV1.5

默認(rèn): {}

一組數(shù)值的HTTP代碼和函數(shù)對象，當(dāng)響應(yīng)時調(diào)用了相應(yīng)的代碼。例如，如果響應(yīng)狀態(tài)是404，將觸發(fā)以下警報：

$.ajax({
  statusCode: {404: function() {
    alert('page not found');
  }
});

success(data, textStatus, jqXHR)Function,Array

請求成功后的回調(diào)函數(shù)。參數(shù)：由服務(wù)器返回，并根據(jù)dataType參數(shù)進(jìn)行處理后的數(shù)據(jù)；描述狀態(tài)的字符串。還有 jqXHR（在jQuery 1.4.x的中，XMLHttpRequest） 對象 。在jQuery 1.5， 成功設(shè)置可以接受一個函數(shù)數(shù)組。每個函數(shù)將被依次調(diào)用。 Ajax 事件。

function (data, textStatus) {
    // data 可能是 xmlDoc, jsonObj, html, text, 等等...
    this; // 調(diào)用本次AJAX請求時傳遞的options參數(shù)
}

traditionalBoolean

如果你想要用傳統(tǒng)的方式來序列化數(shù)據(jù)，那么就設(shè)置為true。請參考工具分類下面的jQuery.param 方法。

timeoutNumber

設(shè)置請求超時時間（毫秒）。此設(shè)置將覆蓋全局設(shè)置。

typeString

(默認(rèn): "GET") 請求方式 ("POST" 或 "GET")， 默認(rèn)為 "GET"。注意：其它 HTTP 請求方法，如 PUT 和 DELETE 也可以使用，但僅部分瀏覽器支持。

urlString

(默認(rèn): 當(dāng)前頁地址) 發(fā)送請求的地址。

usernameString

用于響應(yīng)HTTP訪問認(rèn)證請求的用戶名

xhrFunction

需要返回一個XMLHttpRequest 對象。默認(rèn)在IE下是ActiveXObject 而其他情況下是XMLHttpRequest 。用于重寫或者提供一個增強(qiáng)的XMLHttpRequest 對象。這個參數(shù)在jQuery 1.3以前不可用。

xhrFieldsmapV1.5

一對“文件名-文件值”在本機(jī)設(shè)置XHR對象。例如，如果需要的話，你可以用它來設(shè)置withCredentials為true的跨域請求。

$.ajax({
  type: "GET",
  url: "test.js",
  dataType: "script"
});

$.ajax({
   type: "POST",
   url: "some.php",
   data: "name=John&location=Boston",
   success: function(msg){
     alert( "Data Saved: " + msg );
   }
});

$.ajax({
  url: "test.html",
  cache: false,
  success: function(html){
    $("#results").append(html);
  }
});

 var html = $.ajax({
  url: "some.php",
  async: false
 }).responseText;

 var xmlDocument = [create xml document];
 $.ajax({
   url: "page.php",
   processData: false,
   data: xmlDocument,
   success: handleResponse
 });