jQuery.ajaxSetup()

类别：Ajax > 底层接口

jQuery.ajaxSetup( options )返回类型：

描述：为未来的Ajax数据设置默认值。不建议使用它。

欲了解对$.ajaxSetup()可用的设置的细节，请参阅$.ajax()。

所有后续的Ajax调用都会使用新设置中的函数，除非某次调用$.ajax()时设置了参数覆盖了这个默认值，或者直到下一次调用$.ajaxSetup()。

注意：在这里指定的设置将影响所有对$.ajax()的调用，或者基于Ajax的衍生物，譬如$.get()。这可能导致不想要的行为，因为其它调用者（例如，插件）可能想要常规默认设置。出于那个原因，我们强烈建议不要使用此API。而应该在调用时显式设置选项，或定义简单简单插件来实现它。

例如，下面的代码在反复地ping服务器之前，为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请求设置默认值，url为“/xmlhttp/”，禁用全局处理函数，使用POST而不是GET。然后后面的Ajax请求会发送一些数据，而不需要设置别的任何东西了。

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