jQuery.ajaxSetup()
Posted
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了jQuery.ajaxSetup()相关的知识，希望对你有一定的参考价值。
jQuery.ajaxSetup()函数用于设置AJAX的全局默认设置。
该函数用于更改jQuery中AJAX请求的默认设置选项。之后执行的所有AJAX请求，如果对应的选项参数没有设置，将使用更改后的默认设置。
该函数属于全局jQuery对象。
语法
jQuery 1.1 新增该静态函数。
jQuery.ajaxSetup( settings )
参数
| 参数 | 描述 |
|---|---|
| settings | Object类型一个对象，其中的每个属性表示需要更改默认设置的选项，属性值表示更改后的默认值。 |
关于settings参数可以识别的属性，请参考jQuery.ajax()中的settings参数说明。其中的所有选项参数都是可选设置的。
下面的表格中列出了可能的名称/值：
| 名称 | 值/描述 |
|---|---|
| async | 布尔值，表示请求是否异步处理。默认是 true。 |
| beforeSend(xhr) | 发送请求前运行的函数。 |
| cache | 布尔值，表示浏览器是否缓存被请求页面。默认是 true。 |
| complete(xhr,status) | 请求完成时运行的函数（在请求成功或失败之后均调用，即在 success 和 error 函数之后）。 |
| contentType | 发送数据到服务器时所使用的内容类型。默认是："application/x-www-form-urlencoded"。 |
| context | 为所有 AJAX 相关的回调函数规定 "this" 值。 |
| data | 规定要发送到服务器的数据。 |
| dataFilter(data,type) | 用于处理 XMLHttpRequest 原始响应数据的函数。 |
| dataType | 预期的服务器响应的数据类型。 |
| error(xhr,status,error) | 如果请求失败要运行的函数。 |
| global | 布尔值，规定是否为请求触发全局 AJAX 事件处理程序。默认是 true。 |
| ifModified | 布尔值，规定是否仅在最后一次请求以来响应发生改变时才请求成功。默认是 false。 |
| jsonp | 在一个 jsonp 中重写回调函数的字符串。 |
| jsonpCallback | 在一个 jsonp 中规定回调函数的名称。 |
| password | 规定在 HTTP 访问认证请求中使用的密码。 |
| processData | 布尔值，规定通过请求发送的数据是否转换为查询字符串。默认是 true。 |
| scriptCharset | 规定请求的字符集。 |
| success(result,status,xhr) | 当请求成功时运行的函数。 |
| timeout | 设置本地的请求超时时间（以毫秒计）。 |
| traditional | 布尔值，规定是否使用参数序列化的传统样式。 |
| type | 规定请求的类型（GET 或 POST）。 |
| url | 规定发送请求的 URL。默认是当前页面。 |
| username | 规定在 HTTP 访问认证请求中使用的用户名。 |
| xhr | 用于创建 XMLHttpRequest 对象的函数。 |
返回值
jQuery.ajaxSetup()函数没有返回值，或者说其返回值为undefined。
示例&说明
//设置AJAX的全局默认选项
$.ajaxSetup( {
url: "/index.html" , // 默认URL
aysnc: false , // 默认同步加载
type: "POST" , // 默认使用POST方式
headers: { // 默认添加请求头
"Author": "CodePlayer" ,
"Powered-By": "CodePlayer"
} ,
error: function(jqXHR, textStatus, errorMsg){ // 出错时默认的处理函数
// jqXHR 是经过jQuery封装的XMLHttpRequest对象
// textStatus 可能为： null、"timeout"、"error"、"abort"或"parsererror"
// errorMsg 可能为： "Not Found"、"Internal Server Error"等
// 提示形如：发送AJAX请求到"/index.html"时出错[404]：Not Found
alert( ‘发送AJAX请求到"‘ + this.url + ‘"时出错[‘ + jqXHR.status + ‘]：‘ + errorMsg );
}
} );
$.ajax( {
url: "myurl.php?action=list" ,
type: "GET" ,
success: function( data, textStatus, jqXHR ){
alert("返回数据：" + data);
} ,
error: function(jqXHR, textStatus, errorMsg){
alert("自己的error!");
}
});以上是关于jQuery.ajaxSetup()的主要内容，如果未能解决你的问题，请参考以下文章
用 jQuery.ajaxSetup 实现对请求和响应数据的过滤