jQuery ajaxSetup()方法

我们来详细讲解一下jQuery.ajaxSetup()方法，本文将从以下几个方面对该方法进行介绍：

1. 什么是jQuery.ajaxSetup()方法
2. jQuery.ajaxSetup()方法的用途和作用
3. jQuery.ajaxSetup()方法的调用方式及参数
4. jQuery.ajaxSetup()方法示例1：设置全局默认的ajax属性
5. jQuery.ajaxSetup()方法示例2：设置全局默认的请求头

什么是jQuery.ajaxSetup()方法？

jQuery.ajaxSetup() 方法为将来所有的 AJAX 请求设置默认选项。这些选项在整个网站中全局有效，并且可以在全部的 AJAX 请求中被重写。jQuery.ajaxSetup() 方法必须在执行任何 AJAX 请求前被调用。

jQuery.ajaxSetup()方法的用途和作用？

通过调用jQuery.ajaxSetup()方法，我们可以为我们网站中所有的Ajax请求设置一些默认属性，比如：请求类型、异步或同步、请求超时时间以及错误处理方式等，这样我们在发送请求时就不需要每次都手动设置这些属性了。在某些情况下，也可以为所有Ajax请求统一设置请求头，这样在网络请求时就不需要每次添加请求头了。这节约了我们在写代码时的时间和精力。

jQuery.ajaxSetup()方法的调用方式及参数

调用方式如下：

$.ajaxSetup(options)

其中，options 是一个对象，用于设定在以后所有的 Ajax 请求中的默认属性。
下面是options可以设置的属性：

属性名	描述
accepts	发起请求时，服务器返回数据的类型（json、xml、script）
async	是否为异步请求
cache	指定浏览器是否缓存请求
contentType	发送信息至服务器时内容编码类型（如application/x-www-form-urlencoded、multipart/form-data、text/plain等）
data	发送到服务器的数据（这里需要注意的是，不能使用ajaxsetup函数设置data，只能使用ajax函数）
dataType	预期的服务器响应类型
error	一个函数，可在Ajax请求出错时自动调用
global	是否触发全局Ajax处理事件
ifModified	是否仅在服务器数据改变时获取新数据
isLocal	是否允许本地页面获取数据（即存在跨域访问的情况下，是否允许从本地页面接受到数据）
jsonp	在进行Jsonp跨域访问时设置回调函数的参数名
jsonpCallback	在进行Jsonp跨域访问时设置回调函数的名称
processData	是否自动将数据转换为查询字符串格式
success	一个函数，在服务器正确响应后被调用
timeout	设置Ajax请求超时时间
type	请求方式

示例1：设置全局默认的ajax属性

$.ajaxSetup({
  type: "POST",
  dataType: "json",
  contentType: "application/json",
  error: function(jqXHR, textStatus, errorThrown) {
    console.log("Ajax请求发生错误：" + textStatus + ", " + errorThrown);
  },
  success: function(data, textStatus, jqXHR) {
    console.log("Ajax请求成功：" + JSON.stringify(data));
  }
});

上面代码设置了Ajax请求的默认请求方式为POST，数据类型为json，内容类型为application/json。如果失败则在控制台输出错误信息，成功则在控制台输出成功信息。

当我们在发送Ajax请求时，可以覆盖某些默认属性，例如下面的代码：

$.ajax({
  url: "http://example.com/api",
  type: "GET",
  success: function(data, textStatus, jqXHR) {
    console.log("Ajax请求成功：" + JSON.stringify(data));
  }
});

上面代码中，我们为这个Ajax请求覆盖了默认的请求方式。这个请求方式为GET而不是POST。

示例2：设置全局默认的请求头

$.ajaxSetup({
  headers: {
    "Authorization": "Bearer xxxxxxxx",
    "X-CSRF-Token": "xxxxxxxxxx"
  }
});

上面代码设置了Ajax请求的默认请求头，为Authorization和X-CSRF-Token。我们在发送Ajax请求时可以不用每次设置这些请求头。

当然，我们在具体的Ajax请求中也可以覆盖这些请求头：

$.ajax({
  url: "http://example.com/api",
  headers: {
    "Authorization": "Bearer yyyyyyyy",
    "X-CSRF-Token": "yyyyyyyyy"
  },
  success: function(data, textStatus, jqXHR) {
    console.log("Ajax请求成功：" + JSON.stringify(data));
  }
});

在这个请求中，我们覆盖了全局默认的请求头，发送了Authorization为Bearer yyyyyyyy和X-CSRF-Token为yyyyyyyyy的请求头。

到此，我们就讲解了jQuery.ajaxSetup()方法的完整攻略，希望对你有所帮助。