English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método jQuery ajaxError()

Método AJAX do jQuery

Quando uma solicitação Ajax for concluída e houver um erro, o método ajaxError() anexará uma função a ser chamada. Isso é um AjaxEvent.

Cada vez que uma solicitação Ajax for concluída e houver um erro, o jQuery dispara o evento ajaxError. Neste momento, todos os manipuladores registrados com o método ajaxError() serão executados.

Atenção:Do jQuery 1.8A partir da versão, este método deve ser anexado apenas ao documento.

Sintaxe:

$("document").ajaxError(function(event, xhr, options, thrownError))

Exemplo

Exibe uma mensagem quando a solicitação Ajax falhar:

$("document").ajaxError(function(){
  $("#error").text("Ocorreu um erro!!!");
});
Teste e veja‹/›

Obtendo resultados mais úteis com os parâmetros event, xhr e options:

$("document").ajaxError(function(event, xhr, options){
  $("#error").append("Erro ao solicitar página: "); + options.url);
  $("#error").append(xhr.status);
  $("#error").append(event.type);
});
Teste e veja‹/›

Valor do Parâmetro

ParâmetrosDescrição
function(event, xhr, options, thrownError)Especifique a função a ser executada quando a solicitação for concluída e ocorrer um erro

Parâmetros:

  • event -Contém o objeto de evento

  • xhr-Contém o objeto XMLHttpRequest

  • options-Contém as opções usadas na solicitação AJAX

  • thrownError-Contém exceções JavaScript (se ocorrerem)

Método AJAX do jQuery