返回值:Promisedeferred.pipe([doneFilter], [failFilter])
用于过滤 and/or 链式延迟对象的工具方法。
-
1.6 新增deferred.pipe([doneFilter], [failFilter])
doneFilter (Function) 可选参数， 可选的函数，当延迟对象被受理(resolve)时调用。failFilter (Function) 可选参数， 可选的函数，当延迟对象被拒绝(reject)时调用。 -
1.7 新增deferred.pipe([doneFilter], [failFilter], [progressFilter])
doneFilter (Function) 可选参数， 可选的函数，当延迟对象被受理(resolve)时调用。failFilter (Function) 可选参数， 可选的函数，当延迟对象被拒绝(reject)时调用。progressFilter (Function) 可选参数， 可选的函数，当进度（progress）通知发送到延迟对象上时被调用。
deferred.pipe() 方法返回一个新的 promise，用于过滤状态或通过函数返回的延迟对象的值。doneFilter 和 failFilter 函数过滤原始的延迟对象的受理（resolve) / 拒绝(reject)状态和值。从 jQuery 1.7 开始，该方法可以接受 progressFilter 函数，用于过滤任何原始延迟对象上的 notify 或 notifyWith 调用。这些过滤器可以随着 pipe promise 的 done() 或 fail() 回调函数的调用，返回一个新值，或返回其它可见对象(Deferred, Promise, 等等)，这些可见对象传递了自身的受理（resolve) / 拒绝(reject)状态和传递给 pipe promise 回调函数的值。如果将 null 作为过滤函数，或者不指定过滤函数，那么 pipe promise 被受理（resolve)或被拒绝(reject)时，会使用相同的值作为原始值。
示例:
过滤 resolve 的值:
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 );
});
示例:
过滤 reject 的值:
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
});