deferred.pipe()

发布于 2017-09-11 字数3248 浏览 965 评论 0

所属分类:延迟对象 | 弃用 > 1.8 版本弃用的 API

deferred.pipe( [doneFilter ] [, failFilter ] )返回: Promiseversion deprecated: 1.8

描述: 用用于过滤 and/or 链式延迟对象的工具方法。

  • 添加的版本: 1.6deferred.pipe( [doneFilter ] [, failFilter ] )

    • doneFilter
      类型: Function()

      一个函数,或者函数数组,当Deferred(延迟)对象得到解决时被调用。

    • failFilter
      类型: Function()

      可选的 一个函数,或者函数数组,当Deferred(延迟)对象拒绝时被调用。

  • 添加的版本: 1.7deferred.pipe( [doneFilter ] [, failFilter ] [, progressFilter ] )

    • doneFilter
      类型: Function()

      一个函数,或者函数数组,当Deferred(延迟)对象得到解决时被调用。

    • failFilter
      类型: Function()

      一个函数,或者函数数组,当Deferred(延迟)对象得到拒绝时被调用。

    • progressFilter
      类型: Function()

      一个可选的函数,当进度通知发送给Deferred(延迟)被调用。

Deprecation Notice:(推荐使用的注意事项:)从jQuery 1.8开始, deferred.pipe() 方法过时. 应该使用deferred.then() 代替它。

deferred.pipe()方法返回一个新的promise(允诺),用于过滤状态或通过函数返回的延迟对象的值。doneFilterfailFilter函数过滤原先deferred(延迟)的解决/拒绝的状态和值。从 jQuery 1.7开始,该方法还接受一个progressFilter函数,用来过滤任何访问deferred(延迟)的notifynotifyWith 方法。这些过滤器可以随着 pipe promise 的 done()fail() 回调函数的调用,返回一个新值,或返回其它可见对象(Deferred, Promise, 等等),这些可见对象传递了自身的解决(resolve) / 拒绝(reject)状态和传递给 pipe promise 回调函数的值。如果将 null 作为过滤函数,或者不指定过滤函数,那么 pipe promise 被受理(resolve)或被拒绝(reject)时,会使用相同的值作为原始值。

例子:

Example: 过滤解决值:

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: 链任务:

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

您暂时不能评论!

管理员开启了需要登录才能够评论,你可以免费注册一个本站的账号。

还没有评论!

目前还没有任何评论,快来抢沙发吧!