jQuery deferred.pipe()
Learn all about the jQuery function deferred.pipe().
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.