jQuery ajax 参数详解
语法
$.ajax([setting])
参数
参数 | 描述 |
---|---|
url | 要求为String类型的参数,(默认为当前页地址)发送请求的地址。 |
type | 请求方式(post或get)默认为get |
timeout | 要求为Number类型的参数,设置请求超时时间(毫秒) |
async | 要求为Boolean类型的参数,默认设置为true,所有请求均为异步请求。如果需要发送同步请求,请将此选项设置为false。注意,同步请求将锁住浏览器,用户其他操作必须等 |
cache | 要求为Boolean类型的参数,默认为true(当dataType为script时,默认为false)设置为false将不会从浏览器缓存中加载请求信息。 |
data | 要求为Object或String类型的参数,发送到服务器的数据。对象必须为key/value格式,例如{foo1:”bar1”,foo2:”bar2”},转化为&foo1=bar1&foo2=bar2,附在url后面。 |
dataType | 要求为String类型的参数,预期服务器返回的数据类型,JQuery将自动根据http包mime信息返回responseXML或responseText,并作为回调函数参数传递,可用如下类型:xml、json、html、script(返回纯文本js代码)、text(返回纯文本) |
success | 要求为Function类型的参数,请求成功后调用的回调函数,有两个参数。(1)由服务器返回,并根据dataType参数进行处理后的数据。(2)描述状态的字符串。function(data, textStatus){ //data可能是xmlDoc、jsonObj、html、text等等 this; //调用本次ajax请求时传递的options参数 |
error | 要求为Function类型的参数,请求失败时被调用的函数。该函数有3个参数,即XMLHttpRequest对象、错误信息、捕获的错误对象(可选)。 ajax事件函数如下 function(XMLHttpRequest, textStatus, errorThrown){//通常情况下textStatus和errorThrown只有其中一个包含信息。 this; //调用本次ajax请求时传递的options参数} |
注意
1. error处理错误的函数,只有请求未发送成功或请求的服务器出现异常才会调用,若参数出现错误则会通过success的形式返回。
2. error函数
error:function (XMLHttpRequest, textStatus, errorThrown)
{
}
(默 认: 自动判断 (xml 或 html)) 请求失败时调用时间。参数有以下三个:
参数名 | 含义 |
---|---|
XMLHttpRequest | 错误对象 |
textStatus: | 其值有 “null” 、”timeout”, “error”, “notmodified” 和 “parsererror”。 |
errorThrown | (可选)捕获的错误对象 |
XMLHttpRequest 对象的readyState含义
参数名 | 含义 |
---|---|
0 | (未初始化)还没有调用send()方法 |
1 | (载入)已调用send()方法,正在发送请求 |
2 | (载入完成)send()方法执行完成,已经接收到全部响应内容 |
3 | (交互)正在解析响应内容 |
4 | (完成)响应内容解析完成,可以在客户端调用了 |
$.ajax({
url: "/Handle/Do.aspx",
type: "post",
data: { id: '0' },
dataType: "json",
success: function(msg) {
alert(msg);
},
error: function(XMLHttpRequest, textStatus, errorThrown) {
alert(XMLHttpRequest.status);
alert(XMLHttpRequest.readyState);
alert(textStatus);
},
complete: function(XMLHttpRequest, textStatus) {
this; // 调用本次AJAX请求时传递的options参数
}
});
原文链接:http://www.cnblogs.com/mybest/archive/2011/12/13/2285730.html