jQuery | ajaxSetup() 方法

jQuery中的ajaxSetup()方法可以设置全局_ajax_请求的默认选项。这意味着在整个网页中，所有的_ajax_请求将遵循这些默认设置，除非在单个请求中指定了不同的选项。

语法

$.ajaxSetup(options)

• options: 一个包含一个或多个默认设置的JavaScript对象。

参数说明

以下是options对象中可以包含的可配置属性：

• async: 默认为true，即为异步请求。如果需要发送同步请求，请将此选项设置为false。
• beforeSend: 一个预处理回调函数，可以在发送请求之前修改XHR对象的属性。
• cache: 默认为true，即为开启缓存。如果不需要缓存，请将此选项设置为false。
• complete: 一个请求完成后回调函数（请求成功或失败的都会调用），完成时调用（无论成功或失败）。
• contentType: 发送数据的类型，默认为application/x-www-form-urlencoded。如果需要发送JSON数据，请将此选项设置为application/json。
• data: 需要发送的数据，可以为JSON格式。
• dataType: 预期服务器返回的数据类型。可选的值有：xml、html、script、json、jsonp、text。默认为text。
• error: 请求失败时调用的回调函数。
• global: 默认为true，即为开启全局事件处理。如果需要关闭，请将此选项设置为false。
• headers: 发送额外的请求头信息。
• ifModified: 仅在服务器数据改变时获取新数据。默认为false。
• jsonp: jsonp请求中需要用到的回调函数名。
• jsonpCallback: jsonp名称的自定义函数名称。
• password: 请求认证的密码。
• processData: 默认为true，即为处理数据。如果不希望发送具有特殊用途的数据，请将此选项设置为false。
• scriptCharset: 设定字符集，在从远程站点加载一个脚本时使用。
• success: 请求成功时调用的回调函数，参数是解析后的响应数据。
• timeout: 设置请求的超时时间（毫秒）。如果请求时间超过这个时间，请求将被取消。
• type: 请求类型（GET或POST，默认为GET）。
• url: 发送请求的URL地址。
• username: 请求认证的用户名。

示例

使用ajaxSetup()方法设置一个默认选项：

$.ajaxSetup({
  type: 'POST',
  beforeSend: function () {
    $('#wait').show();
  },
  complete: function () {
    $('#wait').hide();
  }
});

上述示例设置了默认请求类型为POST，并在请求发送前显示一个wait元素(在此设置中未显式定义此元素)。请求完成后隐藏wait元素。这样，对于整个网页中的所有_ajax_请求，都会使用这个默认选项。

总结

ajaxSetup()方法可以设置全局_ajax_请求的默认选项，为整个页面中的所有_ajax_请求提供默认设置。这是一个非常强大和便利的功能，可以大大简化开发人员编写_ajax_请求的工作。需要注意的是，在单个请求中指定的选项将覆盖全局设置。