deferred.pipe()

deferred.pipe( [ doneFilter ], [ failFilter ] ) 官网原E文: Promise

描述: 筛选器和/或链Deferreds的实用程序方法。

  • version added: 1.6deferred.pipe( [ doneFilter ], [ failFilter ] )

    doneFilter 可选函数,当递延得到解决时调用。

    failFilter 可选函数,当递延得被拒绝时调用。

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

Examples:

Example: 过滤解决值:


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 );
});

Example: 过滤器拒值:


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 );
});

Example: 链任务:


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
});

jQuery 1.6 API 中文版Clove整理、修订