deferred.then()
分类:Deferred对象
deferred.then( doneFilter [, failFilter ] [, progressFilter ] )
描述:添加一个处理函数,当一个Deferred对象被解决、被拒绝或者依然在进程中时调用它。
在jQuery 1.8以前的版本中,这些参数必须是一个函数或者多个函数的数组。
对于这个签名,如果不想要那种类型的回调函数,参数可以是null
。作为替代选择,使用.done()
、.fail()
或者.progress()
可以只设置一种类型的回调函数,而不需要筛选状态或者值。
自从jQuery 1.8,deferred.then()
方法返回一个新的promise对象,它可以通过一个函数筛选Deferred对象的状态和值,以代替现在已经被建议弃用的defered.pipe()
方法。该doneFilter
和failFilter
函数筛选了原始的Deferred对象的被解决、被拒绝状态以及值。progressFilter
函数筛选了任何对原始的Deferred对象的.nofity()
方法或.notifyWith()
方法的调用。筛选器函数可以返回一个新修正,传递给promise对象的.done()
回调函数或者.fail()
回调函数,或者它们可以返回另一个可观察的对象(Deferred对象或Promise对象等),它们把它们的已解决、已拒绝状态和值传递给promise对象的回调函数。如果所使用的筛选函数是null,或者没有指定筛选函数,Promise对象被解决或被拒绝时,会用和原始值相同的值。
会按照添加回调函数的顺序执行回调函数。因为deferred.then()
方法返回一个Promise对象,别的Promise对象的方法可以连缀到这个后面,包括额外的.then()
方法。
示例
因为jQuery.get()
方法返回一个jqXHR对象,它派生自一个Deferred对象,所以我们可以使用.then()
方法附加处理函数。
$.get( "test.php" ).then( function() { alert( "$.get succeeded" ); }, function() { alert( "$.get failed!" ); } );
筛选解决值:
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>deferred.then demo</title> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <button>Filter Resolve</button> <p></p> <script> var filterResolve = function() { var defer = $.Deferred(), filtered = defer.then(function( value ) { return value * 2; }); defer.resolve( 5 ); filtered.done(function( value ) { $( "p" ).html( "Value is ( 2*5 = ) 10: " + value ); }); }; $( "button" ).on( "click", filterResolve ); </script> </body> </html>
演示结果
筛选拒绝的值:
var defer = $.Deferred(), filtered = defer.then( null, function( value ) { return value * 3; }); defer.reject( 6 ); filtered.fail(function( value ) { alert( "Value is ( 3*6 = ) 18: " + value ); });
连缀任务:
var request = $.ajax( url, { dataType: "json" } ), chained = request.then(function( data ) { return $.ajax( url2, { data: { user: data.userId } } ); }); chained.done(function( data ) { // 检索自url2的数据,由第一个请求提供 });