jQuery ajaxSetup() 方法


jQuery ajaxSetup() 方法


实例

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

$("button").click(function(){ $.ajaxSetup({ url:"demo_ajax_load.txt",
success:function(result){ $("div").html(result); } }); $.ajax(); });

试一试

定义和用法

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 对象的函数。

更多实例

规定 AJAX 请求的错误处理程序
如何使用错误设置来规定 AJAX 请求的错误处理程序。