deferred.rejectWith()

jQuery

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
      Type: Object
      Context passed to the failCallbacks as the this object.
    • args
      Type: Array
      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.