返回值:Deferred Objectdeferred.pipe([doneFilter],[failFilter],[progressFilter])

jQuery Deferred.pipe() 方法概述

篩選器和/或鏈Deferreds的實用程序方法。

deferred.pipe()方法返回一個新的promise，該過濾器通過一個函數(shù)有關的遞延狀態(tài)和價值。該doneFilter和failFilter原遞延過濾功能的解決/拒絕的狀態(tài)和價值。這些過濾器函數(shù)可以返回一個新的值被傳遞給管道承諾的done()或fail()的回調，或者他們可以返回另一個觀察對象（推遲，承諾等），將通過它的解決/拒絕狀態(tài)和價值，以保證管道的回調。如果使用的是過濾功能null ，或不指定，則管道的承諾將得到解決或原駁回值具有相同。

注意：從 jQuery 1.8 開始，deferred.pipe() 方法過時. 應該使用deferred.then() 代替它。

參數(shù)

doneFilter,failFilterV1.6

doneFilter:可選函數(shù)，當遞延得到解決時調用。

failFilter:可選函數(shù)，當遞延得被拒絕時調用。

doneFilter,failFilter,progressFilterV1.7

doneFilter:可選函數(shù)，當遞延得到解決時調用。

failFilter:可選函數(shù)，當遞延得被拒絕時調用。

progressFilter:一個可選的函數(shù)會在延遲調用被拒絕時被調用

示例

描述:

過濾解決值:

jQuery 代碼:

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

描述:

過濾器拒值:

jQuery 代碼:

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

描述:

鏈任務:

jQuery 代碼:

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