done一直是jQuery成功回调的传统名称,定义为ajax调用中的一个选项。 但是,自实现$.ajax和更复杂的回调以来,$.ajax是实现成功回调的首选方式,因为它可以在任何done上调用。
例如,成功:
$.ajax({
url: '/',
success: function(data) {}
});
例如,完成:
$.ajax({url: '/'}).done(function(data) {});
关于done的好处是,$.ajax的返回值现在是一个延迟的promise,可以绑定到应用程序中的任何其他位置。 所以,假设你想从几个不同的地方进行这个ajax调用。 而不是将您的成功函数作为执行此ajax调用的函数的选项传递,您可以让函数返回$.ajax本身并将您的回调绑定到done,fail,then或其他任何内容。 请注意,pipe是一个回调,无论请求成功还是失败,它都将运行。 then仅在成功时触发。
例如:
function xhr_get(url) {
return $.ajax({
url: url,
type: 'get',
dataType: 'json',
beforeSend: showLoadingImgFn
})
.always(function() {
// remove loading image maybe
})
.fail(function() {
// handle request failures
});
}
xhr_get('/index').done(function(data) {
// do stuff with index data
});
xhr_get('/id').done(function(data) {
// do stuff with id data
});
在可维护性方面,这一点的一个重要好处是,您已将ajax机制包装在特定于应用程序的功能中。 如果您决定将来需要pipe进行不同的操作,或者您使用不同的ajax方法,或者您不再使用jQuery,则只需更改then定义(确保返回承诺或至少为$.ajax) 方法,在上述例子的情况下)。 整个应用程序中的所有其他引用可以保持不变。
pipe可以做更多(更酷)的事情,其中一个是使用then来触发服务器报告的错误失败,即使$.ajax请求本身成功。 例如:
function xhr_get(url) {
return $.ajax({
url: url,
type: 'get',
dataType: 'json'
})
.pipe(function(data) {
return data.responseCode != 200 ?
$.Deferred().reject( data ) :
data;
})
.fail(function(data) {
if ( data.responseCode )
console.log( data.responseCode );
});
}
xhr_get('/index').done(function(data) {
// will not run if json returned from ajax has responseCode other than 200
});
点击此处了解更多关于pipe的信息:[http://api.jquery.com/category/deferred-object/]
注意:自jQuery 1.8起,pipe已被弃用,支持以完全相同的方式使用then。