deferred.pipe()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

deferred.pipe()

分类:Deferred对象 | 建议弃用 > 建议弃用于1.8

返回: Promise
弃用于:1.8

deferred.pipe( [doneFilter ] [, failFilter ] )

描述:实用工具方法,用来筛选并/或连缀多个Deferred对象。

加入于: 1.6
deferred.pipe( [doneFilter ] [, failFilter ] )
  • doneFilter
    类型:Function()
    一个可选的函数,在Deferred对象被解决时调用它。
  • failFilter
    类型:Function()
    一个可选的函数,在Deferred对象被拒绝时调用它。
加入于: 1.7
deferred.pipe( [doneFilter ] [, failFilter ] [, progressFilter ] )
  • doneFilter
    类型:Function()
    一个可选的函数,在Deferred对象被解决时调用它。
  • failFilter
    类型:Function()
    一个可选的函数,在Deferred对象被拒绝时调用它。
  • progressFilter
    类型:Function()
    一个可选的函数,当进程通知发送到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对象被解决或被拒绝时,会用和原始值相同的值。

示例

筛选解决的值:

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

筛选拒绝的值:

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

连缀任务:

var request = $.ajax( url, { dataType: "json" } ),
  chained = request.pipe(function( data ) {
    return $.ajax( url2, { data: { user: data.userId } } );
  });
 
chained.done(function( data ) {
  // 来自url2的数据检索由第一个请求提供
});

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/deferred.pipe.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。