$ .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对象的函数 |