jQuery.ajaxSetup()

jQuery.ajaxSetup( options )

描述: 设置未来(可以理解为全局)的 AJAX请求默认选项。

  • version added: 1.1jQuery.ajaxSetup( options )

    optionsA set of key/value pairs that configure the default Ajax request. All options are optional.

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

所有后面的 Ajax 调用任何函数都将使用新的设置参数,除非被特别的请求, 直到下一次调用$.ajaxSetup().

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

$.ajaxSetup({
  url: 'ping.php',
});

现在每次Ajax请求将自动使用这个URL:

$.ajax({
  data: {'name': 'Tim'},
});

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

举例:

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

$.ajaxSetup({
   url: "/xmlhttp/",
   global: false,
   type: "POST"

 });
 $.ajax({ data: myData });
jQuery 1.6 API 中文版脚本之家整理、修订 (2011年6月)