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

jQuery API 2.2.0

deferred.then()

分类:Deferred对象

返回: Promise

deferred.then( doneFilter [, failFilter ] [, progressFilter ] )

描述:添加一个处理函数,当一个Deferred对象被解决、被拒绝或者依然在进程中时调用它。

加入于: 1.8
deferred.then( doneFilter [, failFilter ] [, progressFilter ] )
  • doneFilter
    类型:Function()
    一个函数,在Deferred对象被解决时调用它。
  • failFilter
    类型:Function()
    一个可选的函数,在Deferred对象被拒绝时调用它。
  • progressFilter
    类型:Function()
    一个可选的函数,当进程通知发送到Deferred对象时调用它。
加入于: 1.5,删除于:1.8
deferred.then( doneCallbacks, failCallbacks )
  • doneCallbacks
    类型:Function()
    一个函数,或者函数数组,当Deferred对象被解决时调用它。.
  • failCallbacks
    类型:Function()
    一个函数,或者函数数组,当Deferred对象被拒绝时调用它。
加入于: 1.7,删除于:1.8
deferred.then( doneCallbacks, failCallbacks [, progressCallbacks ] )
  • doneCallbacks
    类型:Function()
    一个函数,或者函数数组,当Deferred对象被解决时调用它。.
  • failCallbacks
    类型:Function()
    一个函数,或者函数数组,当Deferred对象被拒绝时调用它。
  • progressCallbacks
    类型:Function()
    一个函数,或者函数数组,当Deferred通用进程时调用它。

在jQuery 1.8以前的版本中,这些参数必须是一个函数或者多个函数的数组。

对于这个签名,如果不想要那种类型的回调函数,参数可以是null。作为替代选择,使用.done().fail()或者.progress()可以只设置一种类型的回调函数,而不需要筛选状态或者值。

自从jQuery 1.8,deferred.then()方法返回一个新的promise对象,它可以通过一个函数筛选Deferred对象的状态和值,以代替现在已经被建议弃用的defered.pipe()方法。该doneFilterfailFilter函数筛选了原始的Deferred对象的被解决、被拒绝状态以及值。progressFilter函数筛选了任何对原始的Deferred对象的.nofity()方法或.notifyWith()方法的调用。筛选器函数可以返回一个新修正,传递给promise对象的.done()回调函数或者.fail()回调函数,或者它们可以返回另一个可观察的对象(Deferred对象或Promise对象等),它们把它们的已解决、已拒绝状态和值传递给promise对象的回调函数。如果所使用的筛选函数是null,或者没有指定筛选函数,Promise对象被解决或被拒绝时,会用和原始值相同的值。

会按照添加回调函数的顺序执行回调函数。因为deferred.then()方法返回一个Promise对象,别的Promise对象的方法可以连缀到这个后面,包括额外的.then()方法。

示例

因为jQuery.get()方法返回一个jqXHR对象,它派生自一个Deferred对象,所以我们可以使用.then()方法附加处理函数。

$.get( "test.php" ).then(
  function() {
    alert( "$.get succeeded" );
  }, function() {
    alert( "$.get failed!" );
  }
);

筛选解决值:

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>deferred.then demo</title>
  <script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
 
<button>Filter Resolve</button>
<p></p>
 
<script>
var filterResolve = function() {
  var defer = $.Deferred(),
    filtered = defer.then(function( value ) {
      return value * 2;
    });
 
  defer.resolve( 5 );
  filtered.done(function( value ) {
    $( "p" ).html( "Value is ( 2*5 = ) 10: " + value );
  });
};
 
$( "button" ).on( "click", filterResolve );
</script>
 
</body>
</html>

演示结果

筛选拒绝的值:

var defer = $.Deferred(),
  filtered = defer.then( 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.then(function( data ) {
    return $.ajax( url2, { data: { user: data.userId } } );
  });
 
chained.done(function( data ) {
  // 检索自url2的数据,由第一个请求提供
});

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

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