# deferred.fail()

## deferred.fail ( failCallbacks, failCallbacks ) Returns: Deferred version added: 1.5

- 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.

Description: Add handlers to be called when the Deferred object 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.

## Examples:

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