返回值:Deferred Objectdeferred.pipe([doneFilter],[failFilter],[progressFilter])

概述

篩選器和/或鏈Deferreds的實用程序方法。

deferred.pipe()方法返回一个新的promise,该过滤器通过一个函数有关的递延状态和价值。该doneFilter和failFilter原递延过滤功能的解决/拒绝的状态和价值。这些过滤器函数可以返回一个新的值被传递给管道承诺的done()或fail()的回调,或者他们可以返回另一个观察对象(推迟,承诺等),将通过它的解决/拒绝状态和价值,以保证管道的回调。如果使用的是过滤功能null ,或不指定,则管道的承诺将得到解决或原驳回值具有相同。

參數

doneFilter,failFilterV1.6

doneFilter:可選函數,當遞延得到解決時調用。

failFilter:可選函數,當遞延得被拒絕時調用。

doneFilter,failFilter,progressFilterV1.7

doneFilter:可選函數,當遞延得到解決時調用。

failFilter:可選函數,當遞延得被拒絕時調用。

progressFilter:一個可選的函數會在延遲調用被拒絕時被調用

示例

描述:

過濾解決值:

jQuery 代码:
var defer = $.Deferred(),

    filtered = defer.pipe(function( value ) {

      return value * 2;

    });



defer.resolve( 5 );

filtered.done(function( value ) {

  alert( "Value is ( 2*5 = ) 10: " + value );

});

描述:

過濾器拒值:

jQuery 代码:
var defer = $.Deferred(),

    filtered = defer.pipe( null, function( value ) {

      return value * 3;

    });



defer.reject( 6 );

filtered.fail(function( value ) {

  alert( "Value is ( 3*6 = ) 18: " + value );

});;

描述:

鏈任務:

jQuery 代码:
var request = $.ajax( url, { dataType: "json" } ),

    chained = request.pipe(function( data ) {

      return $.ajax( url2, { data: { user: data.userId } } );

    });



chained.done(function( data ) {

  // data retrieved from url2 as provided by the first request

});