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

Método jQuery ajaxSetup()

Método AJAX do jQuery

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().

Sintaxe:

$.ajaxSetup({name:value, name:value, ...})

Exemplo

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.

Valor do parâmetro

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:

NomeTipo de valorDescrição
asyncBooleanUm valor booleano que indica se a solicitação deve ser processada de forma assíncrona. O valor padrão é true
beforeSend(xhr)FunçãoA função executada antes de enviar a solicitação
cacheBooleanUm valor booleano que indica se a página solicitada deve ser cacheada pelo navegador. O valor padrão é true
complete(xhr,status)FunçãoA função a ser 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 processar os dados originais da XMLHttpRequest
dataTypeStringO tipo de dados esperado na resposta do servidor
error(xhr,status,error)FunçãoA função executada quando a solicitação falhar
globalBooleanUm valor booleano que especifica se o manipulador de eventos AJAX global deve ser acionado. O valor padrão é true
ifModifiedBooleanUm 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 de solicitação jsonp
jsonpCallbackFunçãoEspecifica o nome da função de callback para solicitações jsonp
methodStringEspecifica o método HTTP a ser usado na solicitação (obter ou publicar). O valor padrão é GET
passwordStringEspecifica a senha usada na solicitação de autenticação HTTP
processDataBooleanUm valor booleano que especifica se os dados anexados à solicitação devem ser convertidos em uma string de consulta. O valor padrão é true
scriptCharsetStringEspecificar o conjunto de caracteres da solicitação
statusCodeObjeto ComumObjeto 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çãoFunção a ser executada quando a solicitação for bem-sucedida
timeoutNúmeroTempo de espera local da solicitação (em milissegundos)
traditionalBooleanUm valor booleano que especifica se deve usar o estilo de serialização de parâmetros tradicional
typeStringmethodapelido. Se você usar1.9Para versões do jQuery antes da .0, deve usar type
urlStringEspecificar a URL para onde a solicitação será enviada. O padrão é a página atual
usernameStringEspecificar o nome de usuário a ser usado na autenticação HTTP de acesso
xhrFunçãoFunção usada para criar o objeto XMLHttpRequest

Método AJAX do jQuery