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

Méthode jQuery ajax()

Méthodes Ajax jQuery

$ .ajax() pour exécuter des demandes HTTP (Ajax) asynchrones.

$ .ajax() est la méthode de base pour toutes les demandes Ajax envoyées par jQuery. Il n'est généralement pas nécessaire de appeler cette méthode directement, car il est possible d'utiliser$ .get(),$ .post()etload()et plusieurs méthodes plus avancées, qui sont plus faciles à utiliser. Cependant, si moins d'options courantes sont nécessaires, $ .ajax() peut être utilisé de manière plus flexible.

Syntaxe :

Syntaxe une:1.5+Version:

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

Syntaxe deux :1.0+Version :

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

Exemple

UtiliserAjouterde la demande AJAXVersionModifier le texte de l'élément DIV:1.5Version:

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

UtiliserAjouterde la demande AJAXVersionModifier le texte de l'élément DIV:1.0Version :

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

Demander la page ajax_get.php et envoyer d'autres données :

$.ajax({
  url: "ajax_get.php",
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
    $("div").html(response);
  }
});
Vérifiez et voyez‹/›

Demander la page ajax_get.php, envoyer d'autres données et afficher un message d'alerte d'état :

$.ajax({
  url: "ajax_get.php",
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response, status){
        $("div").html(response);
        alert(status);
  }
});
Vérifiez et voyez‹/›

Utiliser la méthode HTTP POST pour demander la page ajax_post.php :

$.ajax({
  url: "ajax_post.php",
  method: "POST",
  success: function(response){
        $("div").html(response);
  }
});
Vérifiez et voyez‹/›

Utiliser un réglage asynchrone pour spécifier une demande synchrone :

$.ajax({
  url: "ajax_get.php",
  async: false,
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
        $("div").html(response);
  }
});
Vérifiez et voyez‹/›

Utiliser dataType pour spécifier le type de données de la demande :

$.ajax({
  url: ""/javascript/myscript.js",
  dataType: "script"
});
Vérifiez et voyez‹/›

Si la demande Ajax rencontre une erreur, afficher une notification :

$.ajax({
  url: "wrong_file.html",
  success: function(response){
        $("div").html(response);
  },
  error: function(xhr){
        $("div").html("Erreur : " + xhr.status + " " + xhr.statusText);
  }
});
Vérifiez et voyez‹/›

Demander un fichier et informer l'utilisateur à la fin de la tâche. Si la demande échoue, afficher un message de notification :

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);
});
Vérifiez et voyez‹/›

Valeur du paramètre

Définissez un ou plusieurs paires name:value pour la requête AJAX.

Noms possibles : les valeurs du tableau suivant :

NomType de valeurDescription
asyncBooleanUne valeur booléenne indiquant si la requête doit être traitée de manière asynchrone. La valeur par défaut est true
beforeSend(xhr)FonctionLa fonction à exécuter avant l'envoi de la requête
cacheBooleanUne valeur booléenne indiquant si le navigateur doit ou non mettre en cache la page de la requête. La valeur par défaut est true
complete(xhr,status)FonctionLa fonction à exécuter après la fin de la requête (après les fonctions de succès et d'erreur)
contentTypeBooléen ou chaîneLe type de contenu utilisé pour envoyer les données au serveur. La valeur par défaut est : application / x-www-form-urlencoded
contextObjet communSpécifiez la valeur de 'this' pour toutes les fonctions de rappel AJAX liées
dataPlainObject ou String ou ArraySpécifiez les données à envoyer au serveur
dataFilter(data,type)FonctionLa fonction à utiliser pour traiter les données originales de la réponse XMLHttpRequest
dataTypeChaîneLe type de données attendu dans la réponse du serveur
error(xhr,status,error)FonctionLa fonction à exécuter lorsque la requête échoue
globalBooleanUne valeur booléenne indiquant si le gestionnaire d'événements AJAX global doit être déclenché. La valeur par défaut est true
ifModifiedBooleanUne valeur booléenne 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éenRemplacez la fonction de rappel jsonp dans la requête
jsonpCallbackFonctionSpécifiez le nom de la fonction de rappel pour la requête jsonp
methodChaîneSpécifiez la méthode HTTP à utiliser pour la requête (obtenir ou publier). La valeur par défaut est GET
passwordChaîneSpécifiez le mot de passe utilisé pour l'authentification HTTP de la requête
processDataBooleanUne valeur booléenne indiquant si les données associées à la requête doivent être converties en chaîne de recherche. La valeur par défaut est true
scriptCharsetChaîneSpécifiez le jeu de caractères pour la requête
statusCodeObjet communObjet appelé lorsque la réponse a un code HTTP correspondant au nombre et à la fonction
$.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)
traditionalBooleanUn booléen spécifiant si l'encodage des paramètres traditionnel doit être utilisé
typeChaînemethodAlias.1.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 dans les demandes d'authentification HTTP
xhrFonctionFonction utilisée pour créer des objets XMLHttpRequest

Méthodes Ajax jQuery