# deferred.fail()

Categories: Deferred Object

## 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 A function, or array of functions, that are called when the Deferred is rejected.

  failCallbacks 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!"); });