English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
O método $ .ajaxSetup() define valores padrão para solicitações Ajax futuras.
A menos que seja substituído por chamadas individuais, todas as chamadas Ajax subsequentes usando qualquer método usarão os novos valores até a próxima chamada $ .ajaxSetup().
$.ajaxSetup({name:value, name:value, ...})
Defina o URL padrão para todas as solicitações AJAX:
$.ajaxSetup({ url: \"ajax_post.php\" }); //Agora, sempre que for feita uma solicitação AJAX, o URL \"ajax_post.php\" será usado automaticamente: $.ajax({ data: {fname:\"Seagull\", lname:\"Anna\"}, method: \"POST\", success: function(response){ $("div").html(response); } });Teste para ver‹/›
Defina o URL padrão e a função de sucesso para todas as solicitações AJAX:
$.ajaxSetup({ url: \"ajax_data.txt\", success: function(response){ $("div").html(response); } }); $("button").click(function(){ $.ajax(); });Teste para ver‹/›
Se a solicitação AJAX encontrar um erro, exiba uma notificação:
$.ajaxSetup({ url: \"wrong_file.html\", success: function(response){ $("div").html(response); }, error: function(xhr){ $("div").html("Ocorreu um erro: \u0020" + xhr.status + "\u0020" + xhr.statusText); } }); $("button").click(function(){ $.ajax(); });Teste para ver‹/›
Atenção:As configurações especificadas aqui afetarão as$.ajaxou subclasses derivadas de Ajax (comodo $.get())Todas as chamadas. Como outros chamadores (por exemplo, plugins) podem esperar usar configurações padrão normais, isso pode levar a comportamento indesejado. Portanto,Altamente recomendado que você não use o método $.ajaxSetup(). Em vez disso, configure explicitamente as opções na chamada ou defina um plugin simples.
Os parâmetros usam um ou mais pares name:value para especificar as configurações da solicitação AJAX.
Possíveis nomes: os valores na tabela a seguir:
Nome | Tipo de valor | Descrição |
---|---|---|
async | Boolean | Um valor booleano que indica se a solicitação deve ser processada de forma assíncrona. O valor padrão é true |
beforeSend(xhr) | Função | A função executada antes de enviar a solicitação |
cache | Boolean | Um valor booleano que indica se a página solicitada deve ser cacheada pelo navegador. O valor padrão é true |
complete(xhr,status) | Função | A função a ser 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 processar os dados originais da XMLHttpRequest |
dataType | String | O tipo de dados esperado na resposta do servidor |
error(xhr,status,error) | Função | A função executada quando a solicitação falhar |
global | Boolean | Um valor booleano que especifica se o manipulador de eventos AJAX global deve ser acionado. O valor padrão é true |
ifModified | Boolean | 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 de solicitação jsonp |
jsonpCallback | Função | Especifica o nome da função de callback para solicitações jsonp |
method | String | Especifica o método HTTP a ser usado na solicitação (obter ou publicar). O valor padrão é GET |
password | String | Especifica a senha usada na solicitação de autenticação HTTP |
processData | Boolean | Um valor booleano que especifica se os dados anexados à solicitação devem ser convertidos em uma string de consulta. O valor padrão é true |
scriptCharset | String | Especificar o conjunto de caracteres da solicitação |
statusCode | Objeto Comum | Objeto que será chamado quando a resposta tiver o código de HTTP correspondente e a função$.ajax({ statusCode: { 404:function() { alert("Página não encontrada"); } } ) |
success(response,status,xhr) | Função | Função a ser executada quando a solicitação for bem-sucedida |
timeout | Número | Tempo de espera local da solicitação (em milissegundos) |
traditional | Boolean | Um valor booleano que especifica se deve usar o estilo de serialização de parâmetros tradicional |
type | String | methodapelido. Se você usar1.9Para versões do jQuery antes da .0, deve usar type |
url | String | Especificar a URL para onde a solicitação será enviada. O padrão é a página atual |
username | String | Especificar o nome de usuário a ser usado na autenticação HTTP de acesso |
xhr | Função | Função usada para criar o objeto XMLHttpRequest |