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

Método jQuery ajax()

Método Ajax do jQuery

$.ajax() para executar solicitações HTTP (Ajax) assíncronas.

$.ajax() é o método básico de todas as solicitações Ajax enviadas pelo jQuery. Normalmente não é necessário chamar este método diretamente, porque pode usar$.get(),$.post()eload()e várias outras métodos mais avançados, que são mais fáceis de usar. No entanto, se precisar de menos opções comuns, o $.ajax() pode ser usado de maneira mais flexível.

Sintaxe:

Sintaxe um:1.5+Versão:

$.ajax(url, {name:value, name:value, ...})

Sintaxe dois :1.0+Versão:

$.ajax(name:value, name:value, ...)

Exemplo

UsarAdicionardo pedido AJAXVersãoAlterar o texto do elemento DIV:1.5Versão:

$.ajax("ajax_intro.txt", {success: function(response){
  $("div").html(response);
});
Teste para ver‹/›

UsarAdicionardo pedido AJAXVersãoAlterar o texto do elemento DIV:1.0Versão:

$.ajax({
  url: "ajax_intro.txt",
  success: function(response){
    $("div").html(response);
  }
});
Teste para ver‹/›

Solicitar a página ajax_get.php e enviar alguns outros dados:

$.ajax({
  url: "ajax_get.php"
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
    $("div").html(response);
  }
});
Teste para ver‹/›

Solicitar a página ajax_get.php, enviar alguns outros dados e exibir uma mensagem de estado de alerta:

$.ajax({
  url: "ajax_get.php"
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response, status){
        $("div").html(response);
        alert(status);
  }
});
Teste para ver‹/›

Usar o método HTTP POST para solicitar a página ajax_post.php:

$.ajax({
  url: "ajax_post.php",
  method: "POST",
  success: function(response){
        $("div").html(response);
  }
});
Teste para ver‹/›

Usar configurações assíncronas para especificar solicitações síncronas:

$.ajax({
  url: "ajax_get.php"
  async: false,
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
        $("div").html(response);
  }
});
Teste para ver‹/›

Usar dataType para definir o tipo de dados solicitado:

$.ajax({
  url: ""/javascript/myscript.js",
  dataType: "script"
});
Teste para ver‹/›

Se o pedido Ajax encontrar um erro, exibir uma notificação:

$.ajax({
  url: "wrong_file.html",
  success: function(response){
        $("div").html(response);
  },
  error: function(xhr){
        $("div").html("Ocorreu um erro: " + xhr.status + " " + xhr.statusText);
  }
});
Teste para ver‹/›

Solicitar arquivo e notificar o usuário após a conclusão. Se a solicitação falhar, exibir uma notificação:

let request = $.ajax({
  url: "ajax_get.php"
  data: {fname:"Seagull", lname:"Anna"}
});
request.done(function(msg){
  $("div").html(msg);
});
request.fail(function(xhr, textStatus){
  $("div").html("Request failed: ") + textStatus);
});
Teste para ver‹/›

Valor do parâmetro

Os parâmetros especificam um ou mais pares name:value para a solicitação AJAX.

Possíveis nomes: os valores na tabela a seguir:

NomeTipo de valorDescrição
asyncBooleanoUm valor booleano que indica se a solicitação deve ser processada assincronamente. O padrão é true
beforeSend(xhr)FunçãoA função que é executada antes de enviar a solicitação
cacheBooleanoUm valor booleano que indica se a página solicitada deve ser cacheada pelo navegador. O padrão é true
complete(xhr,status)FunçãoA função que é executada após a conclusão da solicitação (após as funções de sucesso e erro)
contentTypeBooleano ou stringO tipo de conteúdo usado ao enviar dados para o servidor. O valor padrão é: 'application' / x-www-form-urlencoded
contextObjeto comumEspecifica o valor de 'this' para todas as funções de callback relacionadas ao AJAX
dataPlainObject ou String ou ArrayEspecifica os dados a serem enviados para o servidor
dataFilter(data,type)FunçãoA função usada para manipular os dados originais da resposta XMLHttpRequest
dataTypeCadeia de caracteresO tipo de dados esperado na resposta do servidor
error(xhr,status,error)FunçãoA função que é executada quando a solicitação falha
globalBooleanoUm valor booleano que especifica se o manipulador de evento AJAX global deve ser acionado pela solicitação. O padrão é true
ifModifiedBooleanoUm valor booleano que especifica se a solicitação deve ser bem-sucedida apenas quando a resposta desde a última solicitação mudou. O valor padrão é: false.
jsonpString ou booleanoSubstitui a função de callback no pedido jsonp
jsonpCallbackFunçãoEspecifica o nome da função de callback para solicitações jsonp
methodCadeia de caracteresEspecifica o método HTTP a ser usado na solicitação. (Obter ou publicar). O padrão é GET
passwordCadeia de caracteresEspecifica a senha usada na solicitação de autenticação HTTP.
processDataBooleanoUm valor booleano que especifica se os dados anexados ao pedido devem ser convertidos em uma string de consulta. O padrão é true
scriptCharsetCadeia de caracteresEspecificar o conjunto de caracteres da solicitação
statusCodeObjeto comumObjeto que será chamado quando a resposta tiver código correspondente, chamando números de código HTTP e funções
$.ajax({
  statusCode:
    404:function()
      alert("Não foi possível encontrar a página");
    }
  }
)})
success(response,status,xhr)FunçãoFunção a ser executada quando a solicitação for bem-sucedida
timeoutNúmeroTempo limite local da solicitação (em milissegundos)
traditionalBooleanoUm valor booleano que especifica se deve usar o estilo de serialização de parâmetros tradicional
typeCadeia de caracteresmethodapelido. Se você usar1.9Para versões do jQuery 1.0 ou anteriores, deve usar type
urlCadeia de caracteresEspecificar a URL para onde a solicitação será enviada. O padrão é a página atual
usernameCadeia de caracteresEspecificar o nome de usuário a ser usado em solicitações de autenticação HTTP
xhrFunçãoFunção usada para criar objetos XMLHttpRequest

Método Ajax do jQuery