返回值:jqXHRjQuery.ajax(url, [settings])

执行异步 HTTP (Ajax) 请求。

1.5 新增jQuery.ajax(url, [settings])

url (String) 将要被请求的 URL 字符串。

settings (Map) 可选参数，一组用于配置 Ajax 请求的键值对。所有的选项都是可选的。任何一个选项的默认值都可以通过 $.ajaxSetup() 来设定。查看下文中的 jQuery.ajax( settings ) 获得完整的参数设置一览。
1.0 新增jQuery.ajax(settings)

settings (Map) 一组用于配置 Ajax 请求的键值对。所有的选项都是可选的。任何一个选项的默认值都可以通过 $.ajaxSetup() 来设定。
acceptsMap

默认值: depends on DataType

在请求头中设置的内容类型（Content-Type）。用于通知服务器该请求需要接收何种类型的返回结果。如果需要修改 accepts 设置，建议在 $.ajaxSetup() 方法里进行修改。

asyncBoolean

默认值: true

默认设置下，所有请求均为异步请求(即默认值为： true)。如果需要发送同步请求，请将此选项设置为 false。跨域请求以及 dataType: "jsonp" 的请求不支持同步方式。注意，同步请求可能会锁住浏览器，用户其它操作必须等待请求完成才可以执行。从 jQuery 1.8 开始，不再建议使用 async: false 。

beforeSend(jqXHR, settings)Function

发送请求前可修改 jqXHR (在 jQuery 1.4.x 之前，是 XMLHTTPRequest) 对象的函数，如添加自定义 HTTP 头等。jqXHR 和设置参数的映射表将作为参数被传递。这是一个 Ajax 事件。如果返回 false 可以取消本次ajax请求。从 jQuery 1.5 开始, beforeSend 被调用时，将不考虑请求的类型。

cacheBoolean

默认值: true, false for dataType 'script' and 'jsonp'

设置为 false 将强制浏览器不缓存请求的页面。当设定成 false 时，会在请求的 URL 中添加 "_=[TIMESTAMP]" 参数。

complete(jqXHR, textStatus)Function, Array

请求完成后被调用的函数 (在 success 或 error 之后被调用)。此方法接受两个参数： jqXHR (在 jQuery 1.4.x 之前，是 XMLHTTPRequest) 对象和一个描述请求状态的字符串 ("success", "notmodified", "error", "timeout", "abort" 或 "parsererror")。从 jQuery 1.5 开始, complete 可以就一个函数数组，每一个函数会按顺序被调用。这是一个 Ajax 事件。

contents (1.5 新增)Map

一个由字符串/正则表达式组成的映射表，用于根据指定的内容类型（Content-Type），解析请求的返回结果。

contentTypeString

默认值: 'application/x-www-form-urlencoded'

发送信息至服务器时的内容编码类型。默认值 "application/x-www-form-urlencoded" 适用于大多数情况。如果你明确的给 $.ajax() 传递了一个内容类型（Content-Type），那么它总是会发送给服务器（即使没有数据要发送）。数据总是以 UTF-8 编码传输的。你必须在服务器端进行适当的解码。

contextObject

这个对象用于设置所有Ajax相关回调函数的上下文。默认情况下，上下文是一个代表在 ajax 请求中使用的参数设置对象($.ajaxSettings 中的设置会被合并到 $.ajax 中)。~~也就是说，让回调函数内 this 指向这个对象（如果不设定这个参数，那么this就指向调用本次AJAX请求时传递的 settings 参数）~~。比如指定一个 DOM 元素作为 context 参数，就能把 complete 回调函数的上下文设置成了这个 DOM 元素。例如：
```
$.ajax({
  url: "test.html",
  context: document.body
}).done(function() { 
  $(this).addClass("done");
});
```
converters (1.5 新增)Map

默认值: {"* text": window.String, "text html": true, "text json": jQuery.parseJSON, "text xml": jQuery.parseXML}

一个由dataType到dataType的转换器映射。每一个转换器的值是一个函数，这个函数返回经转换后的请求结果。

crossDomain (1.5 新增)Boolean

默认值: false for same-domain requests, true for cross-domain requests

如果你想在同一域中进行跨域请求（例如 JSONP）时，例如，想允许服务器端重新定向到另一个域，那么需要将 crossDomain 的值设置成 true。

dataObject, String

发送到服务器的数据。如果它不是字符串格式的话，将自动转换为请求字符串格式。它将被附加在 GET 请求的 URL 之后。查看 processData 选项说明，以禁止此自动转换。对象必须是键值对，如果数据是一个数组，jQuery 会按照 traditional 参数的值(查看下面的说明)，自动将数据序列化成一个同名的多值查询字符串。

dataFilter(data, type)Function

对 XMLHttpRequest 返回的原始数据进行预处理的函数。必须返回处理后的数据。此方法接受 data 和 type 两个参数：data 是服务器返回的原始数据， type 是调用 $.ajax 时提供的 'dataType' 参数。

dataTypeString

默认值: Intelligent Guess (xml, json, script, or html)

预期服务器返回的数据类型。如果不指定，jQuery 将自动根据 HTTP 包中的 MIME 信息来智能判断，比如XML MIME类型会被识别为 XML 。在 jQuery 1.4中， JSON 就会生成一个 JavaScript 对象，而 script 则会执行这个脚本，而其它的任何值都会被当成字符串。可用的类型 (并且其结果会作为 success 回调函数的第一个参数) 有：
- "xml": 返回可被 jQuery 处理的 XML 文档。
- "html": 返回纯文本格式的 HTML；包含的script标签会在插入dom时执行。
- "script": 把响应的结果当作 JavaScript 执行，并将其当作纯文本返回。默认情况下不会通过在URL中附加查询字符串变量 "_=[TIMESTAMP]" 进行自动缓存结果，除非将 cache 参数设置成 true。注意: 在远程请求时(不在同一个域下)，所有POST请求都将转为GET请求。(因为将使用DOM的script标签来加载)
- "json": 把响应的结果当作 JSON 执行，之后返回一个 JavaScript 对象。在 jQuery 1.4 中，JSON 格式的数据以严格的方式解析，任何格式有误的 JSON 都会被拒绝并抛出一个解析错误的异常。 (参考 json.org 获取更多关于 JSON 格式的信息。)
- "jsonp": 以 JSONP 的方式载入 JSON 数据块。会自动在所请求的URL最后添加 "?callback=?"。默认情况下不会通过在URL中附加查询字符串变量 "_=[TIMESTAMP]" 进行自动缓存结果，除非将 cache 参数设置成 true。
- "text": 纯文本字符串。
- 多个由空格分隔的值： 从 jQuery 1.5 开始, jQuery 可以将从内容类型（Content-Type）中接收到的 dataType 转换成你所期望的 dataType。例如，如果你想将一个文本结果当成是XML,就可以使用 "text xml" 作为 dataType。同样的，你也可以通过 "jsonp text xml." 将由 JSONP 请求返回的文本，通过 jQuery 解析成 XML。类似的，当使用更加简短的 "jsonp xml" 时，首先会尝试从 jsonp 到 xml 的转换，如果转换失败，就先将 jsonp 转换成 text, 然后再由 text 转换成 xml。
error(jqXHR, textStatus, errorThrown)Function

请求失败时调用此函数。有以下三个参数：jqXHR 对象(在 jQuery 1.4.x 之前，是 XMLHTTPRequest)，错误信息，发生异常时捕获的异常对象（可选）。如果发生了错误，错误信息（第二个参数）的可能值除了 null 之外，还可能是 "timeout", "error", "abort", 或 "parsererror"。当发生 HTTP 错误时，errorThrown 会得到 HTTP 状态的部分原始内容,例如："没有找到（Not Found）" 或 "服务器内部错误。（Internal Server Error.）"。从 jQuery 1.5 开始 error 可以是一个函数数组，每一个函数会按顺序被调用。 注意: 这个函数在跨域脚本和 JSONP 请求时是不会被调用的。这是一个 Ajax 事件。

globalBoolean

默认值: true

请求时是否触发全局 AJAX 事件。默认值是 true 。设置为 false 将不会触发全局 AJAX 事件，如 ajaxStart 或 ajaxStop。此选项可用于控制不同的 Ajax 事件。

headers (1.5 新增)Map

默认值: {}

在发送请求时，追加到请求头中的键/值对映射。此设置会在 beforeSend 函数调用前被设定。，因此，任何在请求头中的设定值,都会被 beforeSend 函数中的设定所覆盖。

ifModifiedBoolean

默认值: false

仅在服务器数据从上次请求后发生改变时，请求才会成功。~~使用 HTTP 包 Last-Modified 头信息判断。~~默认值是 false ，忽略响应报头。在 jQuery 1.4中，它也会检查服务器指定的 'etag' 来确定数据没有被修改过。

isLocal (1.5.1 新增)Boolean

默认值: depends on current location protocol

允许将当前的环境当成“本地”（例如：文件系统），即使 jQuery 本身在默认情况下不这么做。下列协议将被识别成本地：file, *-extension 和 widget。如果需要改变 isLocal 的设置,建议在 $.ajaxSetup() 函数里设置一次。

jsonpString

在一个 jsonp 请求中重写回调函数的名字。这个值用来替代在 'callback=?' 这种 GET 或 POST 请求中 URL 参数里的 'callback' 部分，比如 {jsonp:'onJsonPLoad'} 会导致将 'onJsonPLoad=?' 传给服务器。从 jQuery 1.5 开始,将 jsonp 选项设置成 false，会防止 jQuery 在 URL 中追加 "?callback" 或尝试使用 "=?" 进行转换。在这种情况下，你应该显式的设置 jsonpCallback。例如, { jsonp: false, jsonpCallback: "callbackName" }

jsonpCallbackString, Function

为 JSONP 请求指定一个回调函数名。这个值将用来取代 jQuery 自动生成的随机函数名。这主要用来让jQuery生成一个独特的函数名，这样管理请求更容易，也能方便地提供回调函数和错误处理。当你想让浏览器缓存 GET 请求的时候，可以指定这个回调函数名。从 jQuery 1.5 开始, 你可以使用函数作为参数, 函数的返回值就是 jsonpCallback 的结果。

mimeType (1.5.1 新增)String

mime 类型，用于覆盖 XHR 中的 mime 类型.

passwordString

用于响应HTTP访问认证请求的密码.

processDataBoolean

默认值: true

默认情况下，通过 data 选项传递进来的数据，如果是一个对象(技术上讲只要不是字符串)，都会处理转化成一个查询字符串，以配合默认内容类型（Content-Type） "application/x-www-form-urlencoded"。如果要发送 DOM 树信息或其它不希望转换的信息，请将此选项设置为 false。

scriptCharsetString

只有当请求时 dataType 为 "jsonp" 或 "script" ，并且 type 是 "GET" 时，才会用于强制修改 charset。通常只在本地的内容和远程的内容编码不同时使用。

statusCode (1.5 新增)Map

默认值: {}

一个映射，其键是 HTTP 状态码，值为该状态码下待执行的函数。例如，下面的例子将在请求返回的状态码是 404 时，弹出一个警告框:
```
$.ajax({
  statusCode: {
    404: function() {
      alert('page not found');
    }
  }
});
```
如果请求成功了，状态码对应的函数会将相同的参数作为 success 回调函数的参数，否则将作为 error 回调函数的参数。

success(data, textStatus, jqXHR)Function, Array

请求成功后的回调函数。函数接受三个参数：服务器返回的根据 dataType 参数进行处理后的数据; 描述状态的字符串; 以及一个 jqXHR 对象(在 jQuery 1.4.x 之前，是 XMLHTTPRequest)。 从 jQuery 1.5 开始, success 可以是一个函数数组，每一个函数会按顺序被调用。 这是一个 Ajax 事件。

timeoutNumber

设置请求超时时间（毫秒）。此设置将覆盖 $.ajaxSetup 里的全局设置。超时期间是从 $.ajax 被调用开始计算的。如果进程或浏览器中其它的请求连接无效时，那么可能是其中的一个请求在被发送前就已经连接超时了。在 jQuery 1.4.x 及之前的版本中, 如果请求超时时，XMLHttpRequest 对象将处于无效的状态，如果此时访问任何该对象的成员，将会导致有异常被抛出。 在 Firefox 3.0+ 之后, 脚本和 JSONP 请求在超时时，不能被取消，即使已经超时了脚本依然会运行。

traditionalBoolean

如果你想要用传统的方式来序列化数据，那么就设置为 true。请参参数序列化方法。

typeString

默认值: 'GET'

请求方式 ("POST" 或 "GET")，默认为 "GET"。 注意： 其它 HTTP 请求方法，如 PUT 和 DELETE ，这里也可以使用，但只有部分浏览器能支持。

urlString

默认值: The current page

将要被请求的 URL 字符串。

usernameString

用于响应HTTP访问认证请求的用户名。

xhrFunction

默认值: ActiveXObject when available (IE), the XMLHttpRequest otherwise

需要返回一个 XMLHttpRequest 对象。默认在IE下是 ActiveXObject 而其他浏览器下是 XMLHttpRequest。用于重写或者提供一个增强的 XMLHttpRequest 对象。~~这个参数在jQuery 1.3以前不可用。~~

xhrFields (1.5.1 新增)Map

由字段名/字段值组成的映射，用于设定原生的 XHR 对象。例如，如果需要的话，在进行跨域请求时，可以使用它来设定 withCredentials 的值为 true。
```
$.ajax({
   url: a_cross_domain_url,
   xhrFields: {
      withCredentials: true
   }
});
```
在 jQuery 1.5 中,由于 withCredentials 属性不会传递给原生的 XHR 对象，因此对于需要使用此属性的 CORS 请求，则只能忽略这个属性。由于这个原因，当需要在 CORS 请求使用该属性时，我们建议使用 jQuery 1.5.1+ 版本。

jQuery 发送的所有 Ajax 请求，内部都会通过调用 $.ajax() 函数来实现。通常没有必要直接调用这个函数，可以使用几个已经封装的简便方法，比如 $.get() 和 .load()。如果你需要使用几个不常用的选项，那么可以使用 $.ajax() 来提高灵活性。

最简单的情况下， $.ajax() 可以不带任何参数直接使用:

$.ajax();

注意： 所有选项的默认值都可以通过 $.ajaxSetup() 函数来全局设置。

上面这个例子中，我们没用使用任何选项，于是默认会载入当前页面的内容，但载入的结果是无法使用的。如果想要进一步处理先前载入的数据，我们就需要使用回调函数来操作了。

jqXHR 对象

从 jQuery 1.5 开始，$.ajax() 返回 jQuery XMLHttpRequest (jqXHR) 对象。该对象是浏览器原生的 XMLHttpRequest 对象的一个超集。例如，该对象包括 responseText 和 responseXML 属性, 也包括一个 getResponseHeader() 方法。当传输机制不为 XMLHttpRequest 时，例如，当发送一个 JSONP 请求，返回一个脚本 tag 时，jqXHR 对象会尽可能的模拟原生的 XHR 功能。

从 jQuery 1.5.1 开始,jqXHR 对象还包括 overrideMimeType() 方法 (该方法在 jQuery 1.4.x 版本中也可用, 但在 jQuery 1.5 中被临时删除了)。.overrideMimeType() 方法可能在 beforeSend() 回调函数中使用, 例如，修改请求头中，返回数据的内容类型（Content-Type）:

$.ajax({
  url: 'http://fiddle.jshell.net/favicon.png',
  beforeSend: function( xhr ) {
    xhr.overrideMimeType( 'text/plain; charset=x-user-defined' );
  }
}).done(function ( data ) {
  if( console && console.log ) {
    console.log("Sample of data:", data.slice(0, 100));
  }
});

从 jQuery 1.5 开始，$.ajax() 返回的 jqXHR 对象，实现了 Promise 接口, 使它拥有了 Promise 的所有属性，方法和行为。(详见延迟对象来获得更多信息)。为了让回调函数的名字统一，便于在 $.ajax() 里使用，jqXHR 同样也提供了 .error(), .success() 和 .complete() 方法。这些方法都带有一个参数，该参数是一个函数，此函数在 $.ajax() 请求结束时被调用,并且这个函数接收的参数，与调用 $.ajax() 函数时的参数是一致。这将允许你在一次请求时，对多个回调函数进行赋值，甚至允许你在请求已经完成后，对回调函数进行赋值(如果该请求已经完成，则回调函数会被立刻调用)。

弃用通知: jqXHR.success(), jqXHR.error() 和 jqXHR.complete() 回调函数在 jQuery 1.8 中将被废弃。为日后代码兼容性考虑，请使用如下方法进行替代 jqXHR.done(), jqXHR.fail() 和 jqXHR.always()。

// Assign handlers immediately after making the request,
// and remember the jqxhr object for this request
var jqxhr = $.ajax( "example.php" )
    .done(function() { alert("success"); })
    .fail(function() { alert("error"); })
    .always(function() { alert("complete"); });

// perform other work here ...

// Set another completion function for the request above
jqxhr.always(function() { alert("second complete"); });

为了 XMLHttpRequest 的向后兼容，jqXHR 对象将会暴露如下属性和方法：

readyState
status
statusText
responseXML and/or responseText 当请求返回的结果是 xml and/or text
setRequestHeader(name, value) 该方法用新值替换旧值，而不是将新值连接到旧值中
getAllResponseHeaders()
getResponseHeader()
abort()

不再提供 onreadystatechange 属性,因为不同的状态可以分别在 success, error, complete 和 statusCode 方法中进行处理。

回调函数

beforeSend, error, dataFilter, success 和 complete 等选项都可以接受一个函数，这个函数会在适当的时机执行。

从 jQuery 1.5 开始, error (fail), success (done) 和 complete (always, 从 jQuery 1.6 开始) 回调函数钩子采用了先进先出的队列管理方式。这意味着你可以为每个回调函数钩子添加多个回调函数。详见延迟对象方法, 延迟对象方法已经为这些 $.ajax() 回调函数钩子做了内部实现。

this 会始终指向传递给 $.ajax 函数选项中的 context 属性所指向的对象。如果没有设置 context ，则 this 会指向 $.ajax 本身。

有些类型的 Ajax 请求，比如 JSONP 和跨域的 GET 请求，本身不使用 XHR。所以在这种情况下，传给回调函数的 XMLHttpRequest 和 textStatus 参数就是 undefined。

下面是 $.ajax() 函数提供的回调函数:

beforeSend 会在发送请求之前被调用，并将 jqXHR 对象和 settings 映射作为参数。
error 会在请求失败时，按照它们被注册的顺序被调用。此方法接收如下三个参数：jqXHR 对象，描述错误类型的字符串，以及一个异常对象（如果有的话）。一些内建的错误会将 "abort", "timeout", "No Transport" 等字符串作为异常对象。
dataFilter 会在请求成功并接收到返回数据之后被调用。此方法接收如下参数：请求到的数据以及 dataType 参数的值。并且必须返回一个新的数据（可以是处理过的），这个数据将传递给 success 回调函数做进一步处理。
success 会在请求成功之后，按照它们被注册的顺序被调用。此方法接收如下三个参数：请求返回的数据，描述请求成功代码的字符串，以及 jqXHR 对象。
complete 无论请求成败与否，它都会在请求结束后，按照它们被注册的顺序被调用。此方法接收两个参数：jqXHR 对象，以及一个包含成功或失败代码的字符串。

例如，如果想直接使用返回的 HTML，可以实现如下 success 函数:

$.ajax({
  url: 'ajax/test.html',
  success: function(data) {
    $('.result').html(data);
    alert('Load was performed.');
  }
});

~~如此简单的例子，还可以用更优雅的方式来替代： .load() 或 $.get()。~~

数据类型

$.ajax() 函数依赖服务器提供的信息来处理返回的数据。如果服务器报告说返回的数据是XML，那么返回的结果就可以用普通的XML方法或者 jQuery 的选择器来遍历。如果检测到到其他类型，比如上例中返回的HTML，则数据就以文本形式来对待。

通过设定 dataType 选项，可以指定成其他不同的数据类型。除了 xml, dataType 还可以是 html, json, jsonp, script, 或 text.

其中， text 和 xml 类型返回的数据不会经过处理。数据仅仅简单的将 jqXHR 的 responseText 或 responseXML 属性传递给 success 回调函数。

注意： 我们必须确保服务器端报告的 MIME 类型与我们选择的 dataType 类型相匹配。比如说，选择 XML 的话，为了与结果一致，服务器端就必须声明 MIME 类型为 text/xml 或 application/xml。

如果指定为 html 类型，任何内嵌的 JavaScript 都会在 HTML 作为一个字符串返回之前被执行。类似的，指定 script 类型的话，也会先执行服务器端生成的 JavaScript 脚本，~~然后再把脚本作为一个文本数据返回。~~然后什么都不返回。

原文如下：If html is specified, any embedded JavaScript inside the retrieved data is executed before the HTML is returned as a string. Similarly, script will execute the JavaScript that is pulled back from the server, then return nothing.

如果指定为 json 类型，则会把获取到的数据作为一个 JavaScript 对象来解析，并且把构建好的对象作为结果返回。为了实现这个目的，首先尝试使用 jQuery.parseJSON()。如果浏览器不支持，则使用一个 Function constructor。格式有误的 JSON 数据会抛出一个错误 (详见 json.org 获得更多帮助)。JSON 数据是一种能很方便通过 JavaScript 解析的结构化数据。如果获取的数据文件存放在远程服务器上（域名不同，也就是跨域获取数据），则需要使用 jsonp 类型来代替。

使用 jsonp 类型的话，会创建一个查询字符串参数 callback=? ，这个参数会加在请求的 URL 后面。服务器端应当在 JSON 数据前加上回调函数名，以便完成一个有效的 JSONP 请求。如果要指定其它回调函数的参数名来取代默认的 callback，可以通过设置 $.ajax() 的 jsonp 参数。

注意： JSONP 是 JSON 格式的扩展。它要求一些服务器端的代码来检测并处理查询字符串参数。更多信息可以参阅最早关于 JSONP 的文章.

当数据需要从远端服务器上获得时(这只可能是用了 script 或 jsonp 数据类型)，则 error 回调函数和全局事件不会被调用。

向服务器发送数据

默认情况下，Ajax 请求使用 GET 方法。如果要使用 POST 方法，可以设定 type 选项。这个选项也会影响 data 选项中的内容如何被发送到服务器上。按照 W3C XMLHTTPRequest 的标准，POST 的数据始终是用 UTF-8 字符集传输的。

data 选项既可以包含一个查询字符串，比如 key1=value1&key2=value2，也可以是一个映射，比如 {key1: 'value1', key2: 'value2'}。如果使用了后者的形式，则数据在发送给服务器前会被 jQuery.param() 转换成查询字符串。这个处理过程也可以通过设置 processData 为 false 来回避。但如果我们希望发送一个 XML 对象给服务器时，这种处理就可能不合适了。在这种情况下，我们还应当设置 contentType 选项，使用其它合适的 MIME 类型，取代默认的 application/x-www-form-urlencoded。

高级选项

global 选项用于在 Ajax 请求时，阻止响应全局注册的 Ajax 事件回调函数，比如 .ajaxSend(), .ajaxError(), 以及其他类似的方法。这在有些时候很有用，比如发送的请求非常频繁且简短的时候，就可以禁用 .ajaxSend() 里设置的载入等待指示器。当遇到跨域脚本或 JSONP 请求时，global 选项将自动被设置成 false。更多关于这些方法的详细信息，请参阅下面的内容。

如果服务器需要HTTP认证，可以使用用户名和密码。通过 username 和 password 选项来设置。

Ajax请求是限时的，所以可以捕获并处理错误警告，来提供更好的用户体验。请求超时这个参数通常就保留其默认值，或者就通过$.ajaxSetup()来全局设定，很少为特定的请求重新设置 timeout 选项。

默认情况下，请求是总会被发出去的，但浏览器有可能从它的缓存中读取数据。要禁止使用缓存的结果，可以设置 cache 参数为 false。如果希望判断数据自从上次请求后是否被更改过，如果没有更改过就报告请求失败的话，可以设置 ifModified 参数为 true。

scriptCharset 参数允许给 <script> 标签的请求设定一个特定的字符集，通常用于 script 或者 jsonp 类型。当脚本和页面字符集不同时，就可以使用这个参数。

Ajax 的第一个字母是 "asynchronous" 的首字母，这意味着所有的操作都是并行的，完成的顺序没有前后关系。$.ajax() 的 async 选项默认值是 true，这意味着在请求开始后，其它代码依然能够执行。强烈不建议把这个选项设置成false（意味着所有的请求都不再是异步的），这会导致浏览器显得反应迟钝。

$.ajax() 函数返回它创建的 XMLHttpRequest对象。通常 jQuery 只在内部处理并创建这个对象，但用户也可以通过 xhr 选项来传递一个自己创建的xhr对象。返回的对象通常已经被丢弃了，但依然提供一个底层接口来观察和操控请求。比如说，调用对象上的 .abort() 可以在请求完成前中止请求。

到目前为止, 由于 Firefox 存在一个 bug，当 .getResponseHeader('Content-Type') 返回非空字符串时，.getAllResponseHeaders() 却返回空字符串。在 Firefox 下，jQuery 不支持自动解码 JSON CORS 返回结果。

下面是一个重写 jQuery.ajaxSettings.xhr 的例子：

var _super = jQuery.ajaxSettings.xhr;
jQuery.ajaxSettings.xhr = function () {
    var xhr = _super(),
        getAllResponseHeaders = xhr.getAllResponseHeaders;

    xhr.getAllResponseHeaders = function () {
        if ( getAllResponseHeaders() ) {
            return getAllResponseHeaders();
        }
        var allHeaders = "";
        $( ["Cache-Control", "Content-Language", "Content-Type",
                "Expires", "Last-Modified", "Pragma"] ).each(function (i, header_name) {

            if ( xhr.getResponseHeader( header_name ) ) {
                allHeaders += header_name + ": " + xhr.getResponseHeader( header_name ) + "\n";
            }
            return allHeaders;
        });
    };
    return xhr;
};

扩展 Ajax

从 jQuery 1.5 开始, jQuery 的 Ajax 实现了包括预过滤器，转换器和传输。允许您更加灵活的扩展 Ajax。更多的信息及相关高级特性，请参见如下页面扩展 Ajax

补充说明:

由于浏览器的安全限制，大多数 "Ajax" 请求都服从同源策略(same origin policy)。即无法从不同的域，子域或协议中正确接收数据。
Script 和 JSONP 请求没有同源策略(same origin policy)的限制。

示例:

保存数据到服务器，成功时显示信息。

jQuery 代码:

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

示例:

装载一个 HTML 网页的最新版本。

jQuery 代码:

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

示例:

发送 XML 数据至服务器。设置 processData 选项为 false，防止自动将数据格式转换成字符串。

jQuery 代码:

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

xmlRequest.done(handleResponse);

示例:

发送一个 id 数据到服务器，并在成功后通知用户。如果请求失败，则向用户发出警告。

jQuery 代码:

var menuId = $("ul.nav").first().attr("id");
var request = $.ajax({
  url: "script.php",
  type: "POST",
  data: {id : menuId},
  dataType: "html"
});

request.done(function(msg) {
  $("#log").html( msg );
});

request.fail(function(jqXHR, textStatus) {
  alert( "Request failed: " + textStatus );
});

示例:

加载并执行 JavaScript 文件。

jQuery 代码:

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

返回值:jqXHRjQuery.ajax(url, [settings])

1.5 新增jQuery.ajax(url, [settings])

1.0 新增jQuery.ajax(settings)

acceptsMap

asyncBoolean

beforeSend(jqXHR, settings)Function

cacheBoolean

complete(jqXHR, textStatus)Function, Array

contents (1.5 新增)Map

contentTypeString

contextObject

converters (1.5 新增)Map

crossDomain (1.5 新增)Boolean

dataObject, String

dataFilter(data, type)Function

dataTypeString

error(jqXHR, textStatus, errorThrown)Function

globalBoolean

headers (1.5 新增)Map

ifModifiedBoolean

isLocal (1.5.1 新增)Boolean

jsonpString

jsonpCallbackString, Function

mimeType (1.5.1 新增)String

passwordString

processDataBoolean

scriptCharsetString

statusCode (1.5 新增)Map

success(data, textStatus, jqXHR)Function, Array

timeoutNumber

traditionalBoolean

typeString

urlString

usernameString

xhrFunction

xhrFields (1.5.1 新增)Map

jqXHR 对象

回调函数

数据类型

向服务器发送数据

高级选项

扩展 Ajax

补充说明:

示例:

jQuery 代码:

示例:

jQuery 代码:

示例:

jQuery 代码:

示例:

jQuery 代码:

示例:

jQuery 代码: