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 方法的任何调用。这些过滤器函数可以返回一个新值传递给管道 promise 的 done() 或 fail() 回调，或者它们可以返回另一个可观察对象（Deferred、Promise 等），该对象将把它的解析/拒绝状态和值传递给管道 promise 的回调。如果使用的过滤器函数为 null 或未指定，则管道 promise 将使用与原始 promise 相同的值解析或拒绝。

示例

过滤器解析值

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