jQuery ajaxSetup() 方法

jQuery Ajax方法

$ .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”值
dataPlainObject或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对象的函数

jQuery Ajax方法