JQuery中$.ajax()方法各参数详解（总结）：

JQuery中$.ajax()方法参数详解（总结）：

在实际的项目中，JQuery中$.ajax()方法有着很大的用处，AJAX 是与服务器交换数据的艺术，它在不重载全部页面的情况下，实现了对部分网页的更新。在这一次项目中，遇到这个场景，一个页面同时局部刷新几个地方，以前没有用过，这一次研究了好久，才发现.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; // 调用本次ajax请求时传递的options参数   }

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”) 发送信息至服务器时内容编码类型。默认值适合大多数应用场合。告诉服务器从浏览器提交过来的数据格式。

例如：我们提交数据时假如使用了 JSON2.js 中方法 JSON.stringify(obj) 格式化为json字符串后，再默认提交就会报错。这个时候就需要指定提交的内容格式为：”application/json”。

data : Object,String —-发送到服务器的数据(参数)。

(1)若data数据类型为JavaScript对象或数组，Jquery在提交之前自动调用JQuery.param()方法把要发送的数据编码成为”application/x-www-form- urlencoded”格式的数据（即 name=value&name1=value1）；JavaScript对象必须为 Key/Value 格式；如果为数组，jQuery 将自动为不同值对应同一个名称。如 {foo:[“bar1”, “bar2”]} 转换为 ‘&foo=bar1&foo=bar2’；

(2)若data数据类型为String类型，则直接默认该数据已经按照”application/x-www-form-urlencoded”格式编码完成，不再转换。

processData选项可以控制是否进行转换。该选项默认为true。

get请求中将附加在url后。

dataType： String –预期服务器返回的数据类型。设定HttpHeader中“Accept”域的内容，告诉服务器浏览器可以想要返回的数据格式类型，同时JQuery也会根据该类型对返回的数据进行处理。如果不指定，jQuery 将自动根据 HTTP 包 MIME 信息返回 responseXML 或 responseText，并作为回调函数参数传递，可用值:

text：返回纯文本字符串。

“xml”: 返回 XML 文档，可用 jQuery 处理。

“html”: 返回纯文本 HTML 信息；包含的script标签会在插入DOM时执行。

“script”: 返回纯文本 JavaScript 代码。不会自动缓存结果。

“json”: 返回 JSON 数据 。JQuery将返回的字符串格式数据自动转化为Javascript对象，便于直接使用obj.property格式访问。若没有指定该选项，即使返回的是JSON格式的字符串，JQuery也不会自动转换。

“jsonp”: JSONP 格式。使用 JSONP 形式调用函数时，如 “myurl?callback=?” jQuery 将自动替换 ? 为正确的函数名，以执行回调函数。

error： Function –(默认: 自动判断 (xml 或 html)) 请求失败时将调用此方法。这个方法有三个参数：XMLHttpRequest 对象，错误信息，（可能）捕获的错误对象。

function (XMLHttpRequest, textStatus, errorThrown) {
// 通常情况下textStatus和errorThown只有其中一个有值           this; // 调用本次ajax请求时传递的options参数 }

Success： Function —请求成功后回调函数。这个方法有两个参数：服务器返回数据，返回状态

function (data, textStatus) {
// data 可能是xmlDoc, jsonObj, html, text, etc...       this; // 调用本次ajax请求时传递的options参数      }

ifModified： Boolean —(默认: false) 仅在服务器数据改变时获取新数据。使用 HTTP 包 Last-Modified 头信息判断。

processData： Boolean —(默认: true) 默认情况下，发送的数据将被转换为对象(技术上讲并非字符串) 以配合默认内容类型 “application/x-www-form-urlencoded”。如果要发送 DOM 树信息或其它不希望转换的信息，请设置为 false。

global： Boolean —(默认: true) 是否触发全局 AJAX 事件。设置为 false 将不会触发全局 AJAX 事件，如 ajaxStart 或 ajaxStop 。可用于控制不同的Ajax事件

dataFilter： Function —给Ajax返回的原始数据进行预处理的函数。

提供data和type两个参数。data是Ajax返回的原始数据，type是调用jQuery.ajax时提供的

dataType参数。函数返回的值将由jQuery进一步处理。

function(data, type){
//返回处理后的数据
return data;
}

username： String —用于响应HTTP访问认证请求的用户名。

password： String —用于响应HTTP访问认证请求的密码。

jsonp： String— 在一个 jsonp 请求中重写回调函数的名字。这个值用来替代在 “callback=?” 这种 GET 或 POST 请求中 URL 参数里的 “callback” 部分，比如 {jsonp:’onJsonPLoad’} 会导致将 “onJsonPLoad=?” 传给服务器。

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

traditional： Boolean —如果你想要用传统的方式来序列化数据，那么就设置为 true。请参考工具分类下面的 jQuery.param 方法。

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

jsonpCallback： String —为 jsonp 请求指定一个回调函数名。这个值将用来取代 jQuery 自动生成的随机函数名。这主要用来让 jQuery 生成度独特的函数名，这样管理请求更容易，也能方便地提供回调函数和错误处理。你也可以在想让浏览器缓存 GET 请求的时候，指定这个回调函数名。

context： Object —这个对象用于设置 Ajax 相关回调函数的上下文。也就是说，让回调函数内 this 指向这个对象（如果不设定这个参数，那么 this 就指向调用本次 AJAX 请求时传递的 options 参数）。比如指定一个 DOM 元素作为 context 参数，这样就设置了 success 回调函数的上下文为这个 DOM 元素。

就像这样：

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

options： Object —可选。AJAX 请求设置。所有选项都是可选的。

下面给出一个简单例子：

> **例子：**

Jquery代码：
function GetQuery(id, name, table) {
$.ajax({
url: "../ajaxHandler/ChartsHandler.ashx",
type: "get",
data: {
"id": id,
"name": name,
"table": table
},
dataType: 'html',
success: function (returnValue) {
$("#bar").html(returnValue);
SubjectQuery(id, name);
},
error: function (returnValue) {
alert("对不起！数据加载失败！");
}
})
}