# jQuery.ajaxSetup()

所属分类：Ajax > 底层接口 英文文档：jQuery.ajaxSetup()

## jQuery.ajaxSetup( options )返回:

描述: 为以后要用到的Ajax请求设置默认的值

- #### 添加的版本: 1.1jQuery.ajaxSetup( options )

  - options
    类型: PlainObject
    一个用来配置Ajax请求的"{键:值}"对，所有的选项都是可选的。

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

所有后面的 Ajax 调用任何函数都将使用新的设置参数,除非它们调用时设置了各自的参数重载了这个默认值。 直到下一次调用`$.ajaxSetup()`.

注意： 此处指定的设置会影响所有 `$.ajax`或基于AJAX的衍生方法，如`$.get()`的调用。这可能会导致不良的行为因为其他调用（例如，插件）可能希望正常的默认设置。出于这个原因，我们强烈建议您不要使用此API。相反我们建议，在调用时明确设置选项或定义一个简单的插件。

举个例子,我们可以事先设置服务器重复响应的默认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 请求默认地址为 "/xmlhttp/"，禁止触发全局 AJAX 事件，用 POST 代替默认 GET 方法。其后的 AJAX 请求不再设置任何选项参数。

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