jQuery.ajaxSetup()

类别: Ajax > 低级接口

jQuery.ajaxSetup( options )返回: PlainObject

描述: 为将来的 Ajax 请求设置默认值。不推荐使用。

有关 $.ajaxSetup() 可用设置的详细信息，请参阅 $.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" }
});

注意: 全局回调函数应通过 .on() 及其相应的全局 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 });