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 });