jQuery,Ajax进阶
学习要点:
1.加载请求
2.错误处理
3.请求全局事件
4.JSON 和 JSONP
5.jqXHR 对象
在 Ajax 课程中,我们了解了最基本的异步处理方式。本章,我们将了解一下 Ajax 的 一些全局请求事件、跨域处理和其他一些问题。
一.加载请求
在 Ajax 异步发送请求时,遇到网速较慢的情况,就会出现请求时间较长的问题。而超 过一定时间的请求,用户就会变得不再耐烦而关闭页面。而如果在请求期间能给用户一些提 示,比如:正在努力加载中...,那么相同的请求时间会让用户体验更加的好一些。
jQuery 提供了两个全局事件,.ajaxStart()和.ajaxStop()。这两个全局事件,只要用户触发 了 Ajax,请求开始时(未完成其他请求)激活.ajaxStart(),请求结束时(所有请求都结束了) 激活.ajaxStop()。
ajaxStart()方法,请求开始时(未完成其他请求)激活.ajaxStart(),在document上使用,参数是匿名函数,可以在函数里做请求时的提示和操作
ajaxStop()方法,请求结束时(所有请求都结束了)激活.ajaxStop(),在document上使用,参数是匿名函数,可以在函数里做请求结束的提示和操作
//ajax请求
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'http://www.test.php',
data: $('form').serialize(),
success: function (response, status, xhr) {
$('#box').html(response);
}
});
}); //监测ajax请求
$(document).ajaxStart(function () { //未完成请求时
$('span').show(); //显示正在请求,请稍等
}).ajaxStop(function () { //请求结束时
$('span').hide(); //隐藏请求提示元素
});
如果请求时间太长,可以设置超时
//ajax请求
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'http://www.test.php',
data: $('form').serialize(),
success: function (response, status, xhr) {
$('#box').html(response);
},
timeout : 500 //如果请求时间太长,可以设置超时
});
}); //监测ajax请求
$(document).ajaxStart(function () { //未完成请求时
$('span').show(); //显示正在请求,请稍等
}).ajaxStop(function () { //请求结束时
$('span').hide(); //隐藏请求提示元素
});
如果某个 ajax 不想触发全局事件,可以设置取消
//ajax请求
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'http://www.test.php',
data: $('form').serialize(),
success: function (response, status, xhr) {
$('#box').html(response);
},
global : false //如果某个 ajax 不想触发全局事件,可以设置取消
});
}); //监测ajax请求
//global : false了就不会触发这两个事件了,这里就不起作用了
$(document).ajaxStart(function () { //未完成请求时
$('span').show(); //显示正在请求,请稍等
}).ajaxStop(function () { //请求结束时
$('span').hide(); //隐藏请求提示元素
});
二.错误处理
Ajax 异步提交时,不可能所有情况都是成功完成的,也有因为代码异步文件错误、网 络错误导致提交失败的。这时,我们应该把错误报告出来,提醒用户重新提交或提示开发者 进行修补。
在之前高层封装中是没有回调错误处理的,比如$.get()、$.post()和.load()。所以,早期 的方法通过全局.ajaxError()事件方法来返回错误信息。而在 jQuery1.5 之后,可以通过连缀 处理使用局部.error()方法即可。而对于$.ajax()方法,不但可以用这两种方法,还有自己的属 性方法 error : function () {}。
$.ajax()使用属性提示错误,error : function () {}。
//ajax请求
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'test.php',
data: $('form').serialize(),
success: function (response, status, xhr) {
$('#box').html(response);
},
error: function (xhr, errorText, errorStatus) { //如果发生错误,返回错误信息
alert(xhr.statusText + ':' + xhr.status);
}
});
});
error()方法提示错误
fail().方法将取代error(),请求失败时调用的回调函数,接收三个形式参数xhr, status, info
$.post()使用连缀.error()方法提示错误,连缀方法将被.fail()取代
$('form input[type=button]').click(function () {
$.post('ttttest.php').error(function (xhr, status, info) { //如果出现错误打印错误信息
alert(xhr.status + ':' + xhr.statusText);
});
});
ajaxError()全局事件提示错误,在document上使用,参数是一个匿名函数,函数接收4个形式参数,event对象, xhr通讯对象, settings, infoError
$.post()使用全局.ajaxError()事件提示错误
//ajax请求
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'test.php',
data: $('form').serialize(),
success: function (response, status, xhr) {
$('#box').html(response);
}
});
}); //ajaxError()全局事件提示错误,在document上使用,参数是一个匿名函数,函数接收4个形式参数,event对象, xhr通讯对象, settings, infoError
$(document).ajaxError(function (event, xhr, settings, infoError) {
alert(xhr.status + ':' + xhr.statusText);
alert(settings + ':' + infoError);
});
三.请求全局事件
jQuery 对于 Ajax 操作提供了很多全局事件方法,.ajaxStart()、.ajaxStop()、.ajaxError() 等事件方法。他们都属于请求时触发的全局事件,除了这些,还有一些其他全局事件:
注意:全局事件方法是所有 Ajax 请求都会触发到,并且只能绑定在 document 上。而局 部方法,则针对某个 Ajax。 对于一些全局事件方法的参数,大部分为对象,而这些对象有哪些属性或方法能调用, 可以通过遍历方法得到。
ajaxSuccess(),对应一个局部方法:.success(),请求成功完成时执行。请求成功时执行
//$.post()使用全局事件方法.ajaxSuccess()
$('form input[type=button]').click(function () {
$.post('test.php', $('form').serialize(), function (response, status, xhr) {
$('#box').html(response);
});
});
//使用全局事件方法.ajaxSuccess()
$(document).ajaxSuccess(function (event, xhr, settings) {
alert(xhr.responseText);
});
success()Ajax局部方法,请求成功完成时执行。请求成功时执行
done().方法将取代success(),请求成功后调用的回调函数,接收三个形式参数response, status, xhr【推荐】
//$.post()使用局部方法.success()
$('form input[type=button]').click(function () {
$.post('test.php', $('form').serialize(), function (response, status, xhr) {
$('#box').html(response);
}).success(function (response, status, xhr) { //success()Ajax局部方法,请求成功完成时执行。请求成功时执行
alert(response);
});
});
ajaxComplete(),对应一个局部方法:.complete(),请求完成后注册一个回调函数。请求完成无论成功失败都执行
$('form input[type=button]').click(function () {
$.post('test.php', $('form').serialize(), function (response, status, xhr) {
alert('成功');
});
});
//$.post()请求完成的全局方法.ajaxComplete()
$(document).ajaxComplete(function (event, xhr, settings) {
alert('完成');
});
complete()Ajax局部方法,请求完成无论成功失败都执行
always().方法将取代complete(),请求完成后调用的回调函数,接收三个形式参数response, status, xhr【推荐】
//$.post()请求完成的局部方法.complete()
$('form input[type=button]').click(function () {
$.post('test.php', $('form').serialize(), function (response, status, xhr) {
alert('成功');
}).complete(function (xhr, status) { //complete()Ajax局部方法,请求完成无论成功失败都执行
alert('完成');
});
});
ajaxSend(),没有对应的局部方法,只有属性 beforeSend,请求发送之前要绑定的函数。请求之前执行
$('form input[type=button]').click(function () {
$.post('test.php', $('form').serialize(), function (response, status, xhr) {
alert('成功');
});
});
//$.post()请求发送之前的全局方法.ajaxSend()
$(document).ajaxSend(function (event, xhr, settings) {
alert('发送请求之前');
});
beforeSend,Ajax局部属性,请求之前执行
//$.ajax()方法,可以直接通过属性设置即可。
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'test.php',
data: $('form').serialize(),
success: function (response, status, xhr) {
$('#box').html(response);
},
complete: function (xhr, status) {
alert('完成' + ' - ' + xhr.responseText + ' - ' + status);
},
beforeSend: function (xhr, settings) { //beforeSend,Ajax局部属性,请求之前执行
alert('请求之前' + ' - ' + xhr.readyState + ' - ' + settings.url);
}
}); });
注意:在 jQuery1.5 版本以后,使用.success()、.error()和.complete()连缀的方法,可以 用.done()、.fail()和.always()取代。
四.JSON 和 JSONP
如果在同一个域下,$.ajax()方法只要设置 dataType 属性即可加载 JSON 文件。而在非 同域下,可以使用 JSONP,但也是有条件的。
ajax()同一个域下加载 JSON 文件
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'test.json',
dataType: 'json',
success: function (response, status, xhr) {
alert(response[0].url);
}
}); });
如果想跨域操作文件的话,我们就必须使用 JSONP。JSONP(JSON with Padding)是一个 非官方的协议,它允许在服务器端集成 Script tags 返回至客户端,通过 javascript callback 的 形式实现跨域访问(这仅仅是 JSONP 简单的实现形式)。
跨域的 PHP 端文件
<?php
$arr = array('a'=>1,'b'=>2,'c'=>3,'d'=>4,'e'=>5);
$result = json_encode($arr);
$callback = $_GET['callback']; //这里是通讯契约
echo $callback."($result)";
?>
$.getJSON()方法跨域获取 JSON
$.getJSON('http://www.li.cc/test.php?callback=?', function (response) { //必须传递契约
console.log(response);
});
ajax()方法跨域获取 JSON
$.ajax({
url: 'http://www.li.cc/test.php?callback=?',
dataType: 'json', //必须指定类型
success: function (response, status, xhr) {
console.log(response);
alert(response.a);
}
});
注意:跨域获取必须传递契约
JSONP,数据类型dataType: 'jsonp',这种类型不需要传递契约【重点】
//跨域获取 JSON
$('form input[type=button]').click(function () {
$.ajax({
type: 'POST',
url: 'http://www.li.cc/test.php',
dataType: 'jsonp', //JSONP,数据类型dataType: 'jsonp',这种类型不需要传递契约
success: function (response, status, xhr) {
alert(response);
}
}); });
五.jqXHR 对象【推荐】
在之前,我们使用了局部方法:.success()、.complete()和.error()。这三个局部方法并不 是 XMLHttpRequest 对象调用的,而是$.ajax()之类的全局方法返回的对象调用的。这个对象, 就是 jqXHR 对象,它是原生对象 XHR 的一个超集。
jqXHR就是$.ajax()返回的本身对象
$('form input[type=button]').click(function () {
var jqXHR = $.ajax({
type: 'POST',
url: 'test.php',
data: $('form').serialize() //表单序列化
});
//此时的jqXHR就是ajax的返回对象,后面还可以连缀
jqXHR.done(function (response, status, xhr) {
alert(response + '1')
}).done(function (response, status, xhr) {
alert(response + '2')
}); });
注意:如果使用 jqXHR 对象的话,那么建议用.done()、.always()和.fail()代 替.success()、.complete()和.error()。以为在未来版本中,很可能将这三种方法废弃取消。
done().方法将取代success(),请求成功后调用的回调函数,接收三个形式参数response, status, xhr
always().方法将取代complete(),请求完成后调用的回调函数,接收三个形式参数response, status, xhr
fail().方法将取代error(),请求失败时调用的回调函数,接收三个形式参数xhr, status, info
使用 jqXHR 的连缀方式比$.ajax()的属性方式有三大好处: 1.可连缀操作,可读性大大提高; 2.可以多次执行同一个回调函数; 3.为多个操作指定回调函数;
多个操作指定回调函数
when()全局方法,可以接收多个jqXHR对象处理,参数是要处理的,jqXHR对象,在方法的匿名函数里接收处理
var jqXHR = $.ajax('test.php');
var jqXHR2 = $.ajax('test2.php');
$.when(jqXHR, jqXHR2).done(function (r1, r2) {
alert(r1[0]);
alert(r2[0]);
});