jquery 手册
Ajax
属性(Attributes)
回调对象(Callbacks ..
核心(Core)
CSS
数据(Data)
延迟对象(Deferred o ..
尺寸(Dimensions)
效果(Effects)
事件(Events)
表单(Forms)
文档操作(Manipulati ..
杂项(Miscellaneou ..
位置(Offset)
插件编写(Plugin Aut ..
属性(Properties)
选择器(Selectors)
遍历(Traversing)
工具(Utilities)

Returns: jQueryjQuery .ajaxError( Function handler(event, jqXHR, ajaxSettings, thrownError) )

描述: 注册一个的ajax请求失败后的函数处理程序。 这是一个 Ajax Event.
  • version added: 1.0
  • .ajaxError( Function handler(event, jqXHR, ajaxSettings, thrownError) )
  • handler(event, jqXHR, ajaxSettings, thrownError) 被调用的函数。

每当一个Ajax请求失败时jQuery触发 ajaxError 事件。所有已注册ajaxError事件处理程序将一次全部执行。

为了观察该方法的行为,我们建立一个最基本的ajax请求:

<button class="trigger">Trigger</button>
<div class="result"></div>
<div class="log"></div>

我们可以将该事件处理程序附加给任何元素:

$("div.log").ajaxError(function() {
  $(this).text( "Triggered ajaxError handler." );
});

现在,我们用jQuery方法发送一个Ajax请求:

$("button.trigger").click(function() {
  $("div.result").load( "ajax/missing.html" );
});

当用户点击按钮触发Ajax请求失败后(请求的文件不存在),显示日志信息。

注意: 因为 .ajaxError()作为一个jQuery对象实例的方法来实现,我们可以在回调函数中使用this关键字指向已选择的元素。

无论什么Ajax请求失败后,所有的 .ajaxError()事件处理程序将会被调用。

$( "div.log" ).ajaxError(function(e, jqxhr, settings, exception) {
  if ( settings.url == "ajax/missing.html" ) {
    $(this).text( "Triggered ajaxError handler." );
  }
});

Examples:

Example:

当一个Ajax请求失败后显示一条信息。
$("#msg").ajaxError(function(event, request, settings){
  $(this).append("<li>Error requesting page " + settings.url + "</li>");
});