deferred.rejectWith()
deferred.rejectWith( context [, args] ) Returns: Deferred
Description: Reject a Deferred object and call any failCallbacks with the given context and args.
-
version added: 1.5deferred.rejectWith( context [, args] )
context Context passed to the failCallbacks as the
this
object.args An optional array of arguments that are passed to the failCallbacks.
Normally, only the creator of a Deferred should call this method; you can prevent other code from changing the Deferred's state by returning a restricted Promise object through deferred.promise()
.
When the Deferred is rejected, any failCallbacks added by deferred.then
or deferred.fail
are called. Callbacks are executed in the order they were added. Each callback is passed the args
from the deferred.reject()
call. Any failCallbacks added after the Deferred enters the rejected state are executed immediately when they are added, using the arguments that were passed to the .reject()
call. For more information, see the documentation for Deferred object.