deferred.fail()

所属分类：延迟对象 英文文档：deferred.fail()

deferred.fail( failCallbacks [, failCallbacks ] )返回: Deferred

描述: 当Deferred（延迟）对象拒绝时，调用添加的处理程序。

  • 添加的版本: 1.5deferred.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()方法。

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