
$ .ajaxSetup()方法为将来的Ajax请求设置默认值。
除非被各个调用覆盖,否则所有使用任何方法进行的后续Ajax调用都将使用新设置,直到下次调用$ .ajaxSetup()为止。
语法:
$.ajaxSetup({name:value, name:value, ...})实例
设置所有AJAX请求的默认URL:
$.ajaxSetup({
url: "ajax_post.php"
});
//现在每次发出Ajax请求时,都会自动使用“ ajax_post.php” URL:
$.ajax({
data: {fname:"Seagull", lname:"Anna"},
method: "POST",
success: function(response){
$("div").html(response);
}
});测试看看‹/›为所有AJAX请求设置默认的URL和成功函数:
$.ajaxSetup({
url: "ajax_data.txt",
success: function(response){
$("div").html(response);
}
});
$("button").click(function(){
$.ajax();
});测试看看‹/›如果Ajax请求遇到错误,则显示通知:
$.ajaxSetup({
url: "wrong_file.html",
success: function(response){
$("div").html(response);
},
error: function(xhr){
$("div").html("发生错误: " + xhr.status + " " + xhr.statusText);
}
});
$("button").click(function(){
$.ajax();
});测试看看‹/›注意:此处指定的设置将影响对$ .ajax或基于Ajax的派生类(如$ .get())的所有调用。由于其他调用者(例如插件)可能期望使用正常的默认设置,因此这可能导致不良行为。因此,强烈建议您不要使用$ .ajaxSetup()方法。而是在调用中显式设置选项或定义一个简单的插件即可。
参数值
参数使用一个或多个name:value对指定AJAX请求的设置。
可能的名称:下表中的值:
| 名称 | 值类型 | 描述 |
|---|---|---|
| async | 布尔型 | 一个布尔值,指示是否应异步处理请求。默认为true |
| beforeSend(xhr) | 函数 | 发送请求之前运行的函数 |
| cache | 布尔型 | 一个布尔值,指示浏览器是否应缓存请求的页面。默认为true |
| complete(xhr,status) | 函数 | 请求完成后要运行的函数(成功和错误功能之后) |
| contentType | 布尔值或字符串 | 将数据发送到服务器时使用的内容类型。默认值为:“ application / x-www-form-urlencoded” |
| context | 普通对象 | 为所有与AJAX相关的回调函数指定“ this”值 |
| data | PlainObject或String或Array | 指定要发送到服务器的数据 |
| dataFilter(data,type) | 函数 | 用于处理XMLHttpRequest的原始响应数据的函数 |
| dataType | 字符串 | 服务器响应预期的数据类型 |
| error(xhr,status,error) | 函数 | 请求失败时运行的函数 |
| global | 布尔型 | 一个布尔值,指定是否触发请求的全局AJAX事件句柄。默认为true |
| ifModified | 布尔型 | 一个布尔值,指定是否只有在自上一个请求以来响应已更改的情况下,请求才成功。默认值为:false。 |
| jsonp | 字符串或布尔 | 覆盖jsonp请求中的回调函数 |
| jsonpCallback | 函数 | 为jsonp请求中的回调函数指定名称 |
| method | 字符串 | 指定用于请求的HTTP方法。(获取或发布)。默认为GET |
| password | 字符串 | 指定在HTTP访问认证请求中使用的密码 |
| processData | 布尔型 | 一个布尔值,指定是否应将与请求一起发送的数据转换为查询字符串。默认为true |
| scriptCharset | 字符串 | 指定请求的字符集 |
| statusCode | 普通对象 | 响应具有相应代码时将调用数字HTTP代码和函数的对象$ .ajax({
statusCode:{
404:function(){
alert(“找不到页面”);
}
}
}); |
| success(response,status,xhr) | 函数 | 请求成功时要运行的函数 |
| timeout | 数字 | 请求的本地超时(以毫秒为单位) |
| traditional | 布尔型 | 一个布尔值,指定是否使用传统的参数序列化样式 |
| type | 字符串 | method的别名。如果您使用的是1.9.0之前的jQuery版本,则应使用type |
| url | 字符串 | 指定将请求发送到的URL。默认为当前页面 |
| username | 字符串 | 指定要在HTTP访问认证请求中使用的用户名 |
| xhr | 函数 | 用于创建XMLHttpRequest对象的函数 |