$.ajax()是所有ajax方法中最底层的方法,所有其他方法都是基于$.ajax()方法的封装。
这个方法只有一个参数,传递一个各个功能键值对的对象。
$.ajax()方法对象参数表:
参数 类型 说明
url String 发送请求的地址
type String 请求方式:POST或GET,默认GET
timeout Number 设置请求超时的时间(毫秒)
data Object或String 发送到服务器的数据,对象或键值对字符串
dataType String 返回的数据类型,比如html、xml、json等
beforeSend Function 发送请求前可修改XMLHttpRequest对象的函数
complete Function 请求完成后调用的回调函数
seccess Function 请求成功后调用的回调函数
error Function 请求失败时调用的回调函数
global Boolean 默认为true,表示是否触发全局Ajax
cache Boolean 设置浏览器缓存响应,默认为true。如果dataType类型为script或jsonp则为false。
content DOM 指定某个元素为与这个请求相关的所有回调函数的上下文。
contentType String 指定请求内容的类型。默认为application/x-www-form-urlencoded。
async Boolean 是否异步处理。默认为true,false为同步处理
processData Boolean 默认为true,数据被处理为URL编码格式。如果为false,则阻止将传入的数据处理为URL编码的格式。
dataFilter Function 用来筛选响应数据的回调函数。
ifModified Boolean 默认为false,不进行头检测。如果为true,进行头检测,当相应内容与上次请求改变时,请求被认为是成功的。
jsonp String 指定一个查询参数名称来覆盖默认的jsonp回调参数名callback。
username String 在HTTP认证请求中使用的用户名
password String 在HTTP认证请求中使用的密码
scriptCharset String 当远程和本地内容使用不同的字符集时,用来设置script和jsonp请求所使用的字符集。
xhr Function 用来提供XHR实例自定义实现的回调函数
traditional Boolean 默认为false,不使用传统风格的参数序列化。如为true,则使用。
$('.ajax_btn').on('click',function(){
$.ajax({
type:"GET",
url:"ajax.php",
data:{
url:"snail",
},
success:function(response,status,xhr){
console.log(response);
}
})
});
注意:对于data属性,如果是GET模式,可以使用三种之前说所的三种形式。如果是POST模式可以使用之前的两种形式。
一.加载请求
在Ajax异步发送请求时,遇到网速较慢的情况,就会出现请求时间较长的问题。而超过一定时间的请求,用户就会变得不再耐烦而关闭页面。而如果在请求期间能给用户一些提示,比如:正在努力加载中...,那么相同的请求时间会让用户体验更加的好一些。
Query提供了两个全局事件,.ajaxStart()和.ajaxStop()。
这两个全局事件,只要用户触发了Ajax,请求开始时(未完成其他请求)激活.ajaxStart(),请求结束时(所有请求都结束了)激活.ajaxStop()。
$('.ajax_load').ajaxStart(function(){
$(this).show();
}).ajaxStop(function(){
$(this).hide();
});
注意:以上代码在jQuery1.8及以后的版本不在有效,需要使用jquery-migrate向下兼容才能运行。新版本中,必须绑定在document元素上。
$(document).ajaxStart(function(){
$('.ajax_load').show();
}).ajaxStop(function(){
$('.ajax_load').hide();
});
// 请求时间过长，导致页面呈现假死状态，所以可以设置超时
$.ajax({
timeout:2000,
});
// 如果某个ajax不想触发全局事件,可以设置取消;比如取消触发.ajaxStart()和.ajaxStop()全局事件：
$.ajax({
global:false,
});
二.错误处理
Ajax异步提交时,不可能所有情况都是成功完成的,也有因为代码异步文件错误、网络错误导致提交失败的。这时,我们应该把错误报告出来,提醒用户重新提交或提示开发者进行修补。
在之前高层封装中是没有回调错误处理的,比如$.get()、$.post()和.load()。所以,早期的方法通过全局.ajaxError()事件方法来返回错误信息。而在jQuery1.5之后,可以通过连缀处理使用局部.error()方法即可。而对于$.ajax()方法,不但可以用这两种方法,还有自己的属性方法error:function(){}。
$('.ajax_btn').on('click',function(){
$.ajax({
type:"GET",
url:"ajax.php",
data:{
url:"snail",
},
success:function(response,status,xhr){
console.log(response);
},
error:function(xhr,errorText,errorStatus){
console.log(xhr);
console.log(errorText);
console.log(errorStatus);
}
})
});
// $.post()使用连缀.error()方法提示错误,连缀方法将被.fail()取代
$.post('ajax.php').error(function(xhr,status,info){
console.log(xhr.status+':'+xhr.statusText);
console.log(status+':'+info);
});
// $.post()使用全局.ajaxError()事件提示错误
$(document).ajaxError(function(event,xhr,settings,infoError){
alert(xhr.status+':'+xhr.statusText);
alert(settings+':'+info);
});
三.请求全局事件
jQuery对于Ajax操作提供了很多全局事件方法,.ajaxStart()、.ajaxStop()、.ajaxError()等事件方法。他们都属于请求时触发的全局事件,除了这些,还有一些其他全局事件:
.ajaxSend(),没有对应的局部方法,只有属性beforeSend,请求发送之前要绑定的函数。
.ajaxComplete(),对应一个局部方法:.complete(),请求完成后注册一个回调函数。
.ajaxSuccess(),对应一个局部方法:.success(),请求成功完成时执行。
注意:全局事件方法是所有Ajax请求都会触发到,并且只能绑定在document上。而局部方法,则针对某个Ajax。对于一些全局事件方法的参数,大部分为对象,而这些对象有哪些属性或方法能调用,可以通过遍历方法得到。
// 遍历settings对象的属性
$(document).ajaxSuccess(function(event,xhr,settings){
for(var i in settings){
console.log(i);
}
});
// $.post()请求完成的局部方法.complete()
$.post().complete(function(xhr,status){
console.log("完成！");
})
// $.post()请求完成的全局方法.ajaxComplete()
$(document).ajaxComplete(function(event,xhr,setting){
console.log("完成！");
})
// $.ajax()方法,可以直接通过属性设置即可。
$.ajax({
type:"POST",
url:"ajax.php",
success:function(data,status,xhr){},
complete:function(xhr,status){},
beforeSend:function(xhr,settints){}
})
注意:在jQuery1.5版本以后,使用.success()、.error()和.complete()连缀的方法,可以用.done()、.fail()和.always()取代。
四.JSON和JSONP
如果在同一个域下,$.ajax()方法只要设置dataType属性即可加载JSON文件。而在非同域下,可以使用JSONP,但也是有条件的。
如果想跨域操作文件的话,我们就必须使用JSONP。JSONP(JSON with Padding)是一个非官方的协议,它允许在服务器端集成Script tags返回至客户端,通过javascriptcallback的形式实现跨域访问(这仅仅是JSONP简单的实现形式)。
$.ajax({
type:"GET",
dataType:"jsonp",
success:function(data,status,xhr){}
})
五.jqXHR对象
在之前,我们使用了局部方法:.success()、.complete()和.error()。这三个局部方法并不是XMLHttpRequest对象调用的,而是$.ajax()之类的全局方法返回的对象调用的。这个对象,就是jqXHR对象,它是原生对象XHR的一个超集。
注意:如果使用jqXHR对象的话,那么建议用.done()、.always()和.fail()代 替.success()、.complete()和.error()。以为在未来版本中,很可能将这三种方法废弃取消。
使用jqXHR的连缀方式比$.ajax()的属性方式有三大好处:
1.可连缀操作,可读性大大提高;
2.可以多次执行同一个回调函数;
3.为多个操作指定回调函数;