jQuery ajaxSetup() 方法
实例
为所有 AJAX 请求设置默认 URL 和 success 函数:
<!DOCTYPE html>
<html>
<head>
<script src="https://libs.baidu.com/jquery/2.1.4/jquery.min.js"></script>
<script>
$(document).ready(function(){
$("button").click(function(){
$.ajaxSetup({url: "/example/ajax/demo.txt", success: function(result){
$("div").html(result);}});
$.ajax();
});
});
</script>
</head>
<body>
<div><h2>让 AJAX 更改此文本</h2></div>
<button>修改文本</button>
</body>
</html>
定义与用法
ajaxSetup()
方法为将来的 AJAX 请求设置默认值。
语法
$.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 对象的函数 |
更多实例
如何使用 error 为 AJAX 请求指定错误处理程序。