jQuery.ajaxSetup()

所属分类：Ajax > 底层接口 英文文档：jQuery.ajaxSetup()

jQuery.ajaxSetup( options )返回:

描述: 为以后要用到的Ajax请求设置默认的值

  • 添加的版本: 1.1jQuery.ajaxSetup( options )

    • options
      类型: PlainObject
      一个用来配置Ajax请求的"{键:值}"对，所有的选项都是可选的。

用于设置$.ajaxSetup()的详细参数, 参见 $.ajax().

所有后面的 Ajax 调用任何函数都将使用新的设置参数,除非它们调用时设置了各自的参数重载了这个默认值。 直到下一次调用$.ajaxSetup().

注意： 此处指定的设置会影响所有 $.ajax或基于AJAX的衍生方法，如$.get()的调用。这可能会导致不良的行为因为其他调用（例如，插件）可能希望正常的默认设置。出于这个原因，我们强烈建议您不要使用此API。相反我们建议，在调用时明确设置选项或定义一个简单的插件。

举个例子,我们可以事先设置服务器重复响应的默认URL参数：

1
2
3
 
$.ajaxSetup({
  url: 'ping.php'
});

现在每次Ajax请求将自动使用这个"ping.php" URL：

1
2
3
4
 
$.ajax({
  // url not set here; uses ping.php
  data: {'name': 'Dan'}
});

注意: 全局回调函数应使用他们各自的全局Ajax事件处理方法-.ajaxStart(), .ajaxStop(), .ajaxComplete(), .ajaxError(), .ajaxSuccess(), .ajaxSend()-设置，而不是为 $.ajaxSetup() 设置 options 对象。

例子:

设置 AJAX 请求默认地址为 "/xmlhttp/"，禁止触发全局 AJAX 事件，用 POST 代替默认 GET 方法。其后的 AJAX 请求不再设置任何选项参数。

1
2
3
4
5
6
7
 
$.ajaxSetup({
   url: "/xmlhttp/",
   global: false,
   type: "POST"
 
 });
 $.ajax({ data: myData });