jquery 手册
Ajax
属性(Attributes)
回调对象(Callbacks ..
核心(Core)
CSS
数据(Data)
延迟对象(Deferred o ..
尺寸(Dimensions)
效果(Effects)
事件(Events)
表单(Forms)
文档操作(Manipulati ..
杂项(Miscellaneou ..
位置(Offset)
插件编写(Plugin Aut ..
属性(Properties)
选择器(Selectors)
遍历(Traversing)
工具(Utilities)

Returns: PromisePromise .deferred.pipe( Function doneFilter, Function failFilter, Function progressFilter )

描述:用于过滤Deferreds链的有效方法。
  • version added: 1.6
  • .deferred.pipe( Function doneFilter, Function failFilter )
  • doneFilter 一个可选函数,当递延解决时调用。
    failFilter 一个可选函数,当递延拒绝时调用。
  • version added: 1.7
  • .deferred.pipe( Function doneFilter, Function failFilter, Function progressFilter )
  • doneFilter 一个可选函数,当递延解决时调用。
    failFilter 一个可选函数,当递延拒绝时调用。
    progressFilter 一个可选函数,当递延拒绝时调用。

deferred.pipe() 方法返回一个新约定,该约定通过一个函数过滤递延的状态和值。 doneFilterfailFilter函数过滤原递延的 解决 / 拒绝状态和值。 从 jQuery 1.7起,这个方法也接受progressFilter函数来过滤任何调用原递延的 notifynotifyWith方法。那些过滤函数可以返回一个新的值,并传递给管道约定的done()fail()回调。 如果过滤函数使用的是null,或未指定,管道约定将使用原来的值。

Examples:

Example:

Filter resolve value:
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 );
});

Example:

过滤拒绝的值:
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 );
});

Example:

Chain tasks:
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
});