deferred.then()

类别：延迟对象

deferred.then( doneFilter [, failFilter ] [, progressFilter ] )返回类型：Promise

描述：添加延迟对象在被解决、被拒绝或依然处于进程时要调用的处理函数。

在jQuery 1.8以前，此参数可以是一个函数，或是函数的数组。

对于所有签名，如果所有的回调函数类型都不想要，参数可以是null。也可以使用.done()、.fail()或.progress()来设置一种回调函数类型，而不筛选状态或值。

自从jQuery 1.8以来，deferred.then()方法返回一个新的应答对象，可以通过一个函数筛选延迟对象的状态和值，替代现在已经淘汰的deferred.pipe()方法。doneFilter和failFilter函数筛选了原始的延迟对象的已解决、已拒绝状态和值。progressFilter函数筛选了任何对原始延迟对象的notify方法或notifyWith方法的调用。这些筛选器函数可以返回一个新值，沿着应答对象的.done()回调函数或.fail()回调函数传递，或者它们可以返回另一个可监视的对象（延迟对象，应答对象，等等），这些对象将把它们的已解决、已拒绝状态和值传递给此应答对象的回调函数。如果所用的筛选器函数是null或者未指定，应答对象在被解决或被拒绝时，会用与原始值相同的值。

按添加回调函数的顺序执行它们。因为deferred.then返回一个应答对象，所以应答对象的其它方法可以连缀在它后面，包括额外的.then()方法。

示例：

因为jQuery.get方法返回一个jqXHR对象，它派生自延迟对象，所以我们可以用.then方法来附加处理函数。

1
2
3
4
5
6
7
 
$.get( "test.php" ).then(
  function() {
    alert( "$.get succeeded" );
  }, function() {
    alert( "$.get failed!" );
  }
);

筛选解决值：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
 
<!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>

演示：

筛选拒绝值：

1
2
3
4
5
6
7
8
9
 
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 );
});

连缀任务：

1
2
3
4
5
6
7
8
 
var request = $.ajax( url, { dataType: "json" } ),
  chained = request.then(function( data ) {
    return $.ajax( url2, { data: { user: data.userId } } );
  });
 
chained.done(function( data ) {
  // data retrieved from url2 as provided by the first request
});