deferred.pipe( [doneFilter ] [, failFilter ] ) Returns: Promise version deprecated: 1.8
Description: Utility method to filter and/or chain Deferreds.
-
version added: 1.6deferred.pipe( [doneFilter ] [, failFilter ] )
-
version added: 1.7deferred.pipe( [doneFilter ] [, failFilter ] [, progressFilter ] )
-
doneFilterType: Function()An optional function that is called when the Deferred is resolved.
-
failFilterType: Function()An optional function that is called when the Deferred is rejected.
-
progressFilterType: Function()An optional function that is called when progress notifications are sent to the Deferred.
-
Deprecation Notice:As of jQuery 1.8, the deferred.pipe() method is deprecated. The deferred.then()
method, which replaces it, should be used instead.
The deferred.pipe()
method returns a new promise that filters the status and values of a deferred through a function. The doneFilter
and failFilter
functions filter the original deferred's resolved / rejected status and values. As of jQuery 1.7, the method also accepts a progressFilter
function to filter any calls to the original deferred's notify
or notifyWith
methods. These filter functions can return a new value to be passed along to the piped promise's done()
or fail()
callbacks, or they can return another observable object (Deferred, Promise, etc) which will pass its resolved / rejected status and values to the piped promise's callbacks. If the filter function used is null
, or not specified, the piped promise will be resolved or rejected with the same values as the original.
Examples:
Example: Filter resolve value:
1
2
3
4
5
6
7
8
9
|
|
Example: Filter reject value:
1
2
3
4
5
6
7
8
9
|
|
Example: Chain tasks:
1
2
3
4
5
6
7
8
9
|
|