deferred.fail()

当Deferred对象拒绝时,调用的处理程序。

deferred.fail(failCallbacks[, failCallbacks ])
  • failCallbacks 类型:Function() 。一个函数,或者函数数组,当Deferred对象拒绝时被调用。
  • failCallbacks 类型:Function() 。可选的一个函数,或者函数数组,当Deferred对象拒绝时被调用。

deferred.fail() 方法接受一个或多个参数,所有这些都参数可以是一个单一的函数或一个函数数组。当Deferred(延迟)拒绝时,failCallbacks被调用。回调是依照他们添加的顺序执行的。 deferred.fail() 返回Deferred对象,Deferred(延迟)可以链接其它的延迟对象,包括增加 deferred.fail() 方法。当Deferred(延迟)拒绝时,failCallbacks执行使用提供给 deferred.resolve() deferred.rejectWith() 方法的参数,依照被添加的顺序调用。有关详细信息,请参阅文件Deferred对象。

例子

jQuery.get 方法返回一个jqXHR对象,这是从一个Deferred(延迟)所得到的,可以附加的成功和失败回调使用 deferred.done() and deferred.fail() 方法。

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