deferred.fail()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

deferred.fail()

分类:Deferred对象

返回: Deferred

deferred.fail( failCallbacks [, failCallbacks ] )

描述:添加一个处理函数,当Deferred对象被拒绝时调用它。

加入于: 1.5
deferred.fail( failCallbacks [, failCallbacks ] )
  • failCallbacks
    类型:Function()
    一个函数,或者函数数组,在Deferred对象被拒绝时调用它。
  • failCallbacks
    类型:Function()
    可选的附加函数、或者函数的数组,在Deferred对象被拒绝时调用它。

deferred.fail()方法接受一个或多个参数,所有的参数要么是一个函数,要么是多个函数构成的数组。当一个Deferred对象被拒绝时,会调用failCallbacks回调函数。会按添加的顺序执行回调函数。因为deferred.fail()返回一个Deferred对象,所以别的Deferred对象的方法可以连缀在这个后面,包括额外的deferred.fail()方法。会按照添加回调函数的顺序执行failCallbacks回调函数,使用提供给调用deferred.reject()方法或deferred.rejectWith()方法的参数。欲得更多信息,参见Deferred对象

示例

因为.jQuery.get()方法返回一个jqXHR对象,它派生自Deferred对象,所以我们可以使用deferred.done()方法和deferred.fail()方法给它附加一个success回调函数和failure回调函数。

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

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/deferred.fail.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。