返回值:Deferred Object deferred.pipe([doneFilter],[failFilter],[progressFilter])
概述
篩選器和/或鏈Deferreds的實用程式方法。
deferred.pipe()方法返回一個新的promise,該過濾器通過一個函式有關的遞延狀態和價值。該doneFilter和failFilter原遞延過濾功能的解決/拒絕的狀態和價值。這些過濾器函式可以返回一個新的值被傳遞給管道承諾的done()或fail()的回撥,或者他們可以返回另一個觀察對像(推遲,承諾等),將通過它的解決/拒絕狀態和價值,以保證管道的回撥。如果使用的是過濾功能null ,或不指定,則管道的承諾將得到解決或原駁回值具有相同。
注意:從 jQuery 1.8 開始,deferred.pipe() 方法過時. 應該使用deferred.then() 代替它。
參數
doneFilter,failFilter V1.6
doneFilter :可選函式,當遞延得到解決時呼叫。
failFilter :可選函式,當遞延得被拒絕時呼叫。
doneFilter,failFilter,progressFilter V1.7
doneFilter :可選函式,當遞延得到解決時呼叫。
failFilter :可選函式,當遞延得被拒絕時呼叫。
progressFilter :一個可選的函式會在延遲呼叫被拒絕時被呼叫
示例
描述:
過濾解決值:
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
});