deferred.fail()

deferred.fail( failCallbacks [, failCallbacks ] ) Returns: Deferred

Description: Add handlers to be called when the Deferred object is rejected.

version added: 1.5deferred.fail( failCallbacks [, failCallbacks ] )
- failCallbacks
  
  Type: Function()
  
  A function, or array of functions, that are called when the Deferred is rejected.
- failCallbacks
  
  Type: Function()
  
  Optional additional functions, or arrays of functions, that are called when the Deferred is rejected.

The deferred.fail() method accepts one or more arguments, all of which can be either a single function or an array of functions. When the Deferred is rejected, the failCallbacks are called. Callbacks are executed in the order they were added. Since deferred.fail() returns the deferred object, other methods of the deferred object can be chained to this one, including additional deferred.fail() methods. The failCallbacks are executed using the arguments provided to the deferred.reject() or deferred.rejectWith() method call in the order they were added. For more information, see the documentation for Deferred object.

Example:

Since the `jQuery.get` method returns a jqXHR object, which is derived from a Deferred, you can attach a success and failure callback using the `deferred.done()` and `deferred.fail()` methods.

                                  
                                    
                                      $.get("test.php")
                                    
                                  
                                  
                                    
                                        .done(function(){ alert("$.get succeeded"); })
                                    
                                  
                                  
                                    
                                        .fail(function(){ alert("$.get failed!"); });

POWERED BYHERONOTE

previous page start next page

deferred.fail()

jQuery

deferred.fail( failCallbacks [, failCallbacks ] ) Returns: Deferred

version added: 1.5deferred.fail( failCallbacks [, failCallbacks ] )

Since the jQuery.get method returns a jqXHR object, which is derived from a Deferred, you can attach a success and failure callback using the deferred.done() and deferred.fail() methods.

Since the `jQuery.get` method returns a jqXHR object, which is derived from a Deferred, you can attach a success and failure callback using the `deferred.done()` and `deferred.fail()` methods.