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

Méthode jQuery ajaxSetup()

Méthodes Ajax jQuery

La méthode $ .ajaxSetup() définit les valeurs par défaut pour les futures requêtes Ajax.

À moins que ce ne soit couvert par les appels individuels, toutes les appels Ajax utilisant n'importe quel méthode utiliseront les valeurs par défaut récemment définies jusqu'à la prochaine appel de $ .ajaxSetup().

Syntaxe :

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

Exemple

Définissez l'URL par défaut pour toutes les requêtes Ajax :

$.ajaxSetup({
  url: "ajax_post.php"
});
//Maintenant, chaque fois qu'une requête Ajax est envoyée, l'URL " ajax_post.php" est utilisée automatiquement :
$.ajax({
  data: {fname:"Seagull", lname:"Anna"},
  method: "POST",
  success: function(response){
    $("div").html(response);
  }
});
Vérifiez et voyez‹/›

Définissez l'URL et la fonction de succès par défaut pour toutes les requêtes Ajax :

$.ajaxSetup({
  url: "ajax_data.txt",
  success: function(response){
    $("div").html(response);
  }
});
$("button").click(function(){
  $.ajax();
});
Vérifiez et voyez‹/›

Si la requête Ajax rencontre une erreur, affichez une notification :

$.ajaxSetup({
  url: "wrong_file.html",
  success: function(response){
    $("div").html(response);
  },
  error: function(xhr){
    $("div").html("发生错误: " + xhr.status + " " + xhr.statusText);
  }
});
$("button").click(function(){
  $.ajax();
});
Vérifiez et voyez‹/›

Attention :Les réglages spécifiés ici affecteront les appels à$.ajaxou des classes dérivées d'Ajax basées sur Ajax (commede $.get())Toutes les appels. Comme d'autres appelants (par exemple, les plugins) peuvent s'attendre à des réglages par défaut normaux, cela peut entraîner un comportement indésirable. Par conséquent,Il est fortement recommandé de ne pas utiliser la méthode $.ajaxSetup(). Au lieu de cela, il est recommandé de définir explicitement les options ou de créer un plugin simple.

Valeur du paramètre

Les paramètres utilisent un ou plusieurs paires name:value pour spécifier les réglages de la requête AJAX.

Noms possibles : valeurs de la table suivante :

NomType de valeurDescription
asyncBooléenUn booléen indiquant si la requête doit être traitée de manière asynchrone. La valeur par défaut est true
beforeSend(xhr)FonctionFonction exécutée avant l'envoi de la requête
cacheBooléenUn booléen indiquant si la page demandée doit être mise en cache par le navigateur. La valeur par défaut est true
complete(xhr,status)FonctionFonction exécutée après la fin de la requête (après les fonctions de succès et d'erreur)
contentTypeBooléen ou chaîneType de contenu utilisé pour envoyer les données au serveur. La valeur par défaut est 'application' / x-www-form-urlencoded
contextObjet normalSpécifie la valeur de 'this' pour toutes les fonctions de rappel AJAX
dataObjet de type PlainObject ou String ou ArraySpécifie les données à envoyer au serveur
dataFilter(data,type)FonctionFonction utilisée pour traiter les données originales de la réponse XMLHttpRequest
dataTypeChaîneType de données attendu dans la réponse du serveur
error(xhr,status,error)FonctionFonction exécutée lorsque la requête échoue
globalBooléenUn booléen indiquant si le gestionnaire d'événements AJAX global doit être déclenché. La valeur par défaut est true
ifModifiedBooléenUn booléen indiquant si la requête est réussie uniquement si la réponse depuis la dernière requête a changé. La valeur par défaut est false
jsonpChaîne ou booléenRemplace la fonction de rappel jsonp dans la requête
jsonpCallbackFonctionSpécifie le nom de la fonction de rappel pour la requête jsonp
methodChaîneSpécifie la méthode HTTP à utiliser pour la requête (obtenir ou publier). La valeur par défaut est GET
passwordChaîneSpécifie le mot de passe utilisé pour l'authentification HTTP. Par défaut, c'est password
processDataBooléenUn booléen, indiquant si les données à envoyer avec la requête doivent être converties en chaîne de requête. La valeur par défaut est true
scriptCharsetChaîneSpécifiez le jeu de caractères pour la requête
statusCodeObjet normalObjet numérique HTTP code et fonction appelé lorsque la réponse a un code correspondant
$.ajax({
  statusCode : {
    404:function() {
      alert("Page introuvable");
    }
  }
)})
success(response,status,xhr)FonctionFonction à exécuter lors d'une réponse réussie
timeoutNumériqueDélai d'attente local de la requête (en millisecondes)
traditionalBooléenUn booléen, indiquant si un style de sérialisation de paramètres traditionnel doit être utilisé
typeChaînemethodAlias. Si vous utilisez1.9Pour les versions de jQuery avant .0, utilisez type
urlChaîneSpécifiez l'URL vers laquelle la requête doit être envoyée. Par défaut, c'est la page actuelle
usernameChaîneSpécifiez le nom d'utilisateur à utiliser pour les demandes d'authentification HTTP
xhrFonctionFonction utilisée pour créer des objets XMLHttpRequest

Méthodes Ajax jQuery