jQuery ajaxSetup() 方法

实例

为所有 AJAX 请求设置默认 URL 和 success 函数:

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <script src="https://libs.baidu.com/jquery/2.1.4/jquery.min.js"></script>
  5. <script>
  6. $(document).ready(function(){
  7. $("button").click(function(){
  8. $.ajaxSetup({url: "/example/ajax/demo.txt", success: function(result){
  9. $("div").html(result);}});
  10. $.ajax();
  11. });
  12. });
  13. </script>
  14. </head>
  15. <body>
  16. <div><h2>让 AJAX 更改此文本</h2></div>
  17. <button>修改文本</button>
  18. </body>
  19. </html>

定义与用法

ajaxSetup() 方法为将来的 AJAX 请求设置默认值。


语法

  1. $.ajaxSetup({name:value, name:value, ... })

这些参数指定具有一个或多个 名称/值 对的 AJAX 请求的设置。

下表中可能的名称/值:

名称值/描述
async一个布尔值,指定是否应异步处理请求。默认值为 true
beforeSend(xhr)发送请求前要运行的函数
cache一个布尔值,指定浏览器是否应缓存请求的页面。默认值为 true
complete(xhr,status)请求完成时要运行的函数(在 success 和 error 函数之后)
contentType向服务器发送数据时使用的内容类型。默认值为: "application/x-www-form-urlencoded"
context为所有与AJAX相关的回调函数指定 "this" 的值
data指定要发送到服务器的数据
dataFilter(data,type)用于处理 XMLHttpRequest 的原始响应数据的函数
dataType服务器响应的预期数据类型
error(xhr,status,error)请求失败时要运行的函数
global一个布尔值,指定是否触发请求的全局AJAX事件句柄。默认值为 true
ifModified一个布尔值,指定仅当响应自上次请求以来发生更改时,请求是否成功。默认值为 false
jsonp在 jsonp 请求中重写回调函数的字符串
jsonpCallback指定 jsonp 请求中回调函数的名称
password指定要在 HTTP 访问身份验证请求中使用的密码
processData一个布尔值,指定是否应将随请求发送的数据转换为查询字符串。默认值为 true
scriptCharset指定请求的字符集
success(result,status,xhr)请求成功时要运行的函数
timeout请求的本地超时(以毫秒为单位)
traditional一个布尔值,指定是否使用传统样式的参数序列化
type指定请求的类型。(GET 或 POST)
url指定将请求发送到的URL。默认值为当前页面
username指定要在 HTTP 访问身份验证请求中使用的用户名
xhr用于创建 XMLHttpRequest 对象的函数

更多实例

为 AJAX 请求设置错误处理

如何使用 error 为 AJAX 请求指定错误处理程序。

分类导航