deferred.pipe()

分类: Deferred 对象 | 已废弃 > 1.8 版已废弃

deferred.pipe( [doneFilter ] [, failFilter ] )返回: Promise版本废弃: 1.8

描述: 用于过滤和/或链接 Deferred 的实用方法。

废弃通知:自 jQuery 1.8 起，deferred.pipe() 方法已废弃。应改用 deferred.then() 方法，它取代了此方法。

deferred.pipe() 方法返回一个新的 promise，它通过一个函数过滤 deferred 的状态和值。doneFilter 和 failFilter 函数过滤原始 deferred 的已解决/已拒绝状态和值。自 jQuery 1.7 起，此方法还接受一个 progressFilter 函数来过滤对原始 deferred 的 notify 或 notifyWith 方法的任何调用。这些过滤函数可以返回一个新值以传递给 piped promise 的 done() 或 fail() 回调，或者它们可以返回另一个可观察对象（Deferred、Promise 等），该对象将把其已解决/已拒绝状态和值传递给 piped promise 的回调。如果使用的过滤函数为 null 或未指定，则 piped promise 将以与原始 deferred 相同的值解决或拒绝。

示例

示例 1

过滤解决值

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

示例 2

过滤拒绝值

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

示例 3

链式任务

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