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

### 概述

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

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

注意：从 jQuery 1.8 开始，deferred.pipe() 方法过时. 应该使用deferred.then() 代替它。

### 参数

#### doneFilter,failFilter V1.6

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

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

#### doneFilter,failFilter,progressFilter V1.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
    });