概述 deferred.then( doneFilter [, failFilter ] [, progressFilter ] )
返回值:Promise
描述: 当Deferred(延迟)对象解决,拒绝或仍在进行中时,调用添加处理程序。
在jQuery 1.8之前,参数可以是一个函数或函数数组。
对于上面所有的特征,如果没有这种类型的回调是需要的,参数可以为null
。或者,使用.done()
,.fail()
或者 .progress()
设置只有一种未经过滤的状态或值的回调类型。
从jQuery 1.8开始, 方法返回一个新的promise(承诺),通过一个函数,可以过滤deferred(延迟)的状态和值。替换现在过时的deferred.pipe()
方法。 doneFilter
和 failFilter
函数过滤原deferred(延迟)的解决/拒绝的状态和值。 progressFilter
函数过滤器的任何调用到原有的deferred(延迟)的notify
和 notifyWith
的方法。
这些过滤器函数可以返回一个新的值传递给的 promise(承诺)的.done()
或 .fail()
回调,或他们可以返回另一个观察的对象(递延,承诺等)传递给它的解决/拒绝的状态和值promise(承诺)的回调。
如果过滤函数是空,或没有指定,promise(承诺)将得到与原来值相同解决(resolved)或拒绝(rejected)。
回调是依照他们添加的顺序执行的。一旦deferred.then
返回Promise(承诺),链接其它的延迟对象,包括增加.then()
方法。
示例
由于 jQuery.get 方法返回 jqXHR 对象,该对象继承自延迟对象,所以我们可以添加 .then 方法。
- $.get("test.php").then(
- function(){ alert("$.get succeeded"); },
- function(){ alert("$.get failed!"); }
- );
Filter the resolve value:
- <!DOCTYPE html>
- <html>
- <head>
- <script src="http://code.jquery.com/jquery-latest.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>