English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
$.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 um:1.5+Versão:
$.ajax(url, {name:value, name:value, ...})
Sintaxe dois :1.0+Versão:
$.ajax(name:value, name:value, ...)
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‹/›
Os parâmetros especificam um ou mais pares name:value para a solicitação AJAX.
Possíveis nomes: os valores na tabela a seguir:
Nome | Tipo de valor | Descrição |
---|---|---|
async | Booleano | Um valor booleano que indica se a solicitação deve ser processada assincronamente. O padrão é true |
beforeSend(xhr) | Função | A função que é executada antes de enviar a solicitação |
cache | Booleano | Um valor booleano que indica se a página solicitada deve ser cacheada pelo navegador. O padrão é true |
complete(xhr,status) | Função | A função que é executada após a conclusão da solicitação (após as funções de sucesso e erro) |
contentType | Booleano ou string | O tipo de conteúdo usado ao enviar dados para o servidor. O valor padrão é: 'application' / x-www-form-urlencoded |
context | Objeto comum | Especifica o valor de 'this' para todas as funções de callback relacionadas ao AJAX |
data | PlainObject ou String ou Array | Especifica os dados a serem enviados para o servidor |
dataFilter(data,type) | Função | A função usada para manipular os dados originais da resposta XMLHttpRequest |
dataType | Cadeia de caracteres | O tipo de dados esperado na resposta do servidor |
error(xhr,status,error) | Função | A função que é executada quando a solicitação falha |
global | Booleano | Um valor booleano que especifica se o manipulador de evento AJAX global deve ser acionado pela solicitação. O padrão é true |
ifModified | Booleano | Um 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. |
jsonp | String ou booleano | Substitui a função de callback no pedido jsonp |
jsonpCallback | Função | Especifica o nome da função de callback para solicitações jsonp |
method | Cadeia de caracteres | Especifica o método HTTP a ser usado na solicitação. (Obter ou publicar). O padrão é GET |
password | Cadeia de caracteres | Especifica a senha usada na solicitação de autenticação HTTP. |
processData | Booleano | Um valor booleano que especifica se os dados anexados ao pedido devem ser convertidos em uma string de consulta. O padrão é true |
scriptCharset | Cadeia de caracteres | Especificar o conjunto de caracteres da solicitação |
statusCode | Objeto comum | Objeto 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ção | Função a ser executada quando a solicitação for bem-sucedida |
timeout | Número | Tempo limite local da solicitação (em milissegundos) |
traditional | Booleano | Um valor booleano que especifica se deve usar o estilo de serialização de parâmetros tradicional |
type | Cadeia de caracteres | methodapelido. Se você usar1.9Para versões do jQuery 1.0 ou anteriores, deve usar type |
url | Cadeia de caracteres | Especificar a URL para onde a solicitação será enviada. O padrão é a página atual |
username | Cadeia de caracteres | Especificar o nome de usuário a ser usado em solicitações de autenticação HTTP |
xhr | Função | Função usada para criar objetos XMLHttpRequest |