deferred.pipe()

类别：延迟对象 | 已淘汰 > 淘汰于1.8

deferred.pipe( [doneFilter ] [, failFilter ] )返回类型：Promiseversion deprecated: 1.8

描述： 实用方法，用来筛选和/或前缀延迟对象。

泺通知：自从jQuery 1.8，deferred.pipe()方法被淘汰了。应该用deferred.then()方法代替它。

deferred.pipe()方法返回一个新的应答，通过函数筛选了以及延迟对象的状态和值。doneFilter函数和failFilter函数筛选了原始的迟延对象的已解决、已拒绝状态和值。自从jQuery 1.7以来，此方法还接受progressFilter函数以筛选任何对原始的延迟对象的notify方法或notifyWith方法的调用。这些筛选器函数可的返回一个新值，新值沿着被管道传递应答对象的done()回调函数或fail()回调函数传递，筛选器函数也可以返回另一个可观察的对象（延迟对象、应答对象等等），并把它的已解决、已拒绝状态和值传给被管道传送的应答对象的回调函数。如果所有的筛选器函数是null，或没有指定，被管道传递的应答对象在被解决或被拒绝时，会用与原始值相同的值。

示例：

筛选解决值：

1
2
3
4
5
6
7
8
9
 
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 );
});

筛选拒绝值：

1
2
3
4
5
6
7
8
9
 
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 );
});

连缀任务：

1
2
3
4
5
6
7
8
 
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
});