jQuery.ajaxSetup()
为以后要用到的Ajax请求设置默认的值
jQuery.ajaxSetup(options)
- options类型: PlainObject。一个用来配置Ajax请求的"{键:值}"对,所有的选项都是可选的。
用于设置$.ajaxSetup()
的详细参数,参见$.ajax()
.
所有后面的 Ajax 调用任何函数都将使用新的设置参数,除非它们调用时设置了各自的参数重载了这个默认值。直到下一次调用$.ajaxSetup()
.
注意:此处指定的设置会影响所有$.ajax
或基于AJAX的衍生方法,如$.get()
的调用。这可能会导致不良的行为因为其他调用(例如,插件)可能希望正常的默认设置。出于这个原因,我们强烈建议您不要使用此API。相反我们建议,在调用时明确设置选项或定义一个简单的插件。
举个例子,我们可以事先设置服务器重复响应的默认URL参数:
$.ajaxSetup({ url: 'ping.php' });
现在每次Ajax请求将自动使用这个"ping.php" URL:
$.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 请求不再设置任何选项参数。
$.ajaxSetup({ url: "/xmlhttp/", global: false, type: "POST" }); $.ajax({ data: myData });