ajax参数详解
ajax请求参数解析
1、url [Object]
⼀个⽤来包含发送请求的URL字符串
2、accepts [Map]
默认：取决于数据类型
内容类型发送请求头，告诉服务器什么样的响应会被接收返回。如果accepts设置需要修改，推荐在$.ajaxSetup()⽅法中做⼀次
3、async [Boolean]
默认：true
默认设置下，所有请求均为异步请求，如果需要发送同步请求，请将此选项设置为false。注意，如果需要发送同步请求。将此选项设置为false。注意，同步请求将锁住浏览器，⽤户其它操作必须等待请求完
成后才可以执⾏
4、beforeSend(XHR) [Function]
发送请求前可修改 XMLHttpRequest 对象的函数，如添加⾃定义 HTTP 头。XMLHttpRequest 对象是唯⼀的参数。这是⼀个Ajax 事件。如果返回false可以取消本次ajax请求。
5、cache [Boolean]
(默认: true,dataType为script和jsonp时默认为false) jQuery 1.2 新功能，设置为 false 将不缓存此页⾯。
6、complete(XHR, TS) [Function]
请求完成后回调函数 (请求成功或失败之后均调⽤)。参数： XMLHttpRequest 对象和⼀个描述成功请求类型的字符串
7、contents [Map]
⼀个以"{字符串：正则表达式}"配对的对象，⽤来确定jQuery将如何解析响应，给定其内容类型。
8、contentType [String]
(默认: "application/x-www-form-urlencoded") 发送信息⾄服务器时内容编码类型。默认值适合⼤多数情况。如果你明确地传递了⼀个content-type给 $.ajax() 那么他必定会发送给服务器（即使没有数据要发送）
9、context [Object]
这个对象⽤于设置Ajax相关回调函数的上下⽂。也就是说，让回调函数内this指向这个对象（如果不设定这个参数，那么this就指向调⽤本次AJAX请求时传递的options参数）。⽐如指定⼀个DOM元素作为context参数，这样就设置了success回调函数的上下⽂为这个DOM元素。
10、crossDomain [map]
默认：同域请求为false
跨域请求为true如果你想强制跨域请求（如JSONP形式）同⼀域，设置crossDomain为true。这使得例如，服务器端重定向到另⼀个域
11、data [Object,String]
发送到服务器的数据。将⾃动转换为请求字符串格式。GET 请求中将附加在 URL 后。查看 processData 选项说明以禁⽌此⾃动转换。必须为 Key/Value 格式。如果为数组，jQuery 将⾃动为不同值对应同⼀个名称。如 {foo:["bar1", "bar2"]} 转换为
"&foo=bar1&foo=bar2"。
12、dataFilter [Function]
给Ajax返回的原始数据的进⾏预处理的函数。提供data和type两个参数：data是Ajax返回的原始数据，type是调⽤jQuery.ajax时提供的dataType参数。函数返回的值将由jQuery进⼀步处理。
13、dataType [String]
预期服务器返回的数据类型。如果不指定，jQuery 将⾃动根据 HTTP 包 MIME 信息来智能判断，⽐如XML MIME类型就被识别为XML。在1.4中，JSON就会⽣成⼀个JavaScript对象，⽽script则会执⾏这个脚本。随后服务器端返回的数据会根据这个值解析后，传递给回调函数。可⽤值:
"xml": 返回 XML ⽂档，可⽤ jQuery 处理。
"html": 返回纯⽂本 HTML 信息；包含的script标签会在插⼊dom时执⾏。
"script": 返回纯⽂本 JavaScript 代码。不会⾃动缓存结果。除⾮设置了"cache"参数。'''注意：'''在远程请求时(不在同⼀个域下)，所有POST请求都将转为GET请求。(因为将使⽤DOM的script标签来加载)
"json": 返回 JSON 数据。
"jsonp": JSONP 格式。使⽤ JSONP形式调⽤函数时，如 "myurl?callback=?" jQuery 将⾃动替换 ? 为正确的函数名，以执⾏回调函数。
"text": 返回纯⽂本字符串
14、error [Function]
(默认: ⾃动判断 (xml 或 html)) 请求失败时调⽤此函数。有以下三个参数：XMLHttpRequest 对象、错误信息、（可选）捕获的异常对象。如果发⽣了错误，错误信息（第⼆个参数）除了得到null之外，还可能是"timeout", "error", "notmodified" 和
"parsererror"。
15、headers [map]
Default: {}
⼀个额外的"{键：值}"对映射到请求⼀起发送。此设置被设置之前beforeSend函数被调⽤；因此，消息头中的值设置可以在覆盖beforeSend函数范围内的任何设置。
16、jsonp [String]
在⼀个jsonp请求中重写回调函数的名字。这个值⽤来替代在"callback=?"这种GET或POST请求中URL参数⾥的"callback"部分，⽐如{jsonp:'onJsonPLoad'}会导致将"onJsonPLoad=?"传给服务器。
17、jsonpCallback [String]
为jsonp请求指定⼀个回调函数名。这个值将⽤来取代jQuery⾃动⽣成的随机函数名。这主要⽤来让jQuery⽣成度独特的函数名，这样管理请求更容易，也能⽅便地提供回调函数和错误处理。你也可以在想让浏览器缓存GET请求的时候，指定这个回调函数名。
18、mimeType [String]
⼀个mime类型⽤来覆盖XHR的 MIME类型。
19、password [String]
⽤于响应HTTP访问认证请求的密码
20、processData [Boolean]
(默认: true) 默认情况下，通过data选项传递进来的数据，如果是⼀个对象(技术上讲只要不是字符串)，都会处理转化成⼀个查询字符串，以配合默认内容类型 "application/x-www-form-urlencoded"。如果要发送 DOM 树信息或其它不希望转换的信息，请设置为 false。
21、scriptCharset [String]
只有当请求时dataType为"jsonp"或"script"，并且type是"GET"才会⽤于强制修改charset。通常只在本地和远程的内容编码不同时使⽤。
22、statusCode [map]
默认: {}
⼀组数值的HTTP代码和函数对象，当响应时调⽤了相应的代码。例如，如果响应状态是404，将触发以下警报：
$.ajax({
statusCode: {404: function() {
alert('page not found');
}
});
23、success(data, textStatus, jqXHR) [Function,Array]
请求成功后的回调函数。参数：由服务器返回，并根据dataType参数进⾏处理后的数据；描述状态的字符串。还有 jqXHR（在jQuery 1.4.x的中，XMLHttpRequest）对象。在jQuery 1.5，成功设置可以接受⼀个函数数组。每个函数将被依次调⽤。24、traditional [Boolean]
如果你想要⽤传统的⽅式来序列化数据，那么就设置为true。请参考⼯具分类下⾯的jQuery.param ⽅法。
25、timeout [Number]
设置请求超时时间（毫秒）。此设置将覆盖全局设置。
26、type [String]
(默认: "GET") 请求⽅式 ("POST" 或 "GET")，默认为 "GET"。注意：其它 HTTP 请求⽅法，如 PUT 和 DELETE 也可以使⽤，但仅部分浏览器⽀持。
27、username [String]
⽤于响应HTTP访问认证请求的⽤户名
案例
描述:
加载并执⾏⼀个 JS ⽂件。
jQuery 代码:
$.ajax({
type: "GET",
url: "test.js",
dataType: "script"
});
描述:
保存数据到服务器，成功时显⽰信息。
jQuery 代码:
$.ajax({
type: "POST",
url: "some.php",
data: "name=John&location=Boston",
success: function(msg){
alert( "Data Saved: " + msg );
}
});
描述:
装⼊⼀个 HTML ⽹页最新版本。
jQuery 代码:
$.ajax({
url: "test.html",
cache: false,
success: function(html){
$("#results").append(html);
}
});
描述:
同步加载数据。发送请求时锁住浏览器。需要锁定⽤户交互操作时使⽤同步⽅式。
jQuery 代码:
var html = $.ajax({
url: "some.php",
async: false
}).responseText;
描述:
发送 XML 数据⾄服务器。设置 processData 选项为 false，防⽌⾃动转换数据格式。jQuery 代码:
var xmlDocument = [create xml document];
$.ajax({
url: "page.php",
jquery ajax例子processData: false,
data: xmlDocument,
success: handleResponse
});
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论