jQuery ajax()Méthode
Exemples
Utilisez une requête AJAX pour modifier le texte d'un élément <div> :
Essayez-le vous-même »
Définition et utilisation
La méthode ajax() est utilisée pour effectuer une requête AJAX (HTTP asynchrone).
Toutes les méthodes AJAX de jQuery utilisent la méthode ajax(). Cette méthode est généralement utilisée pour les requêtes que les autres méthodes ne peuvent pas effectuer.
Syntaxe
Ce paramètre spécifie une ou plusieurs paires nom/valeur pour la requête AJAX.
Le tableau suivant répertorie les paires nom/valeur possibles :
| Name | Valeur/Description |
|---|---|
| async | Une valeur booléenne indiquant si la requête est traitée de manière asynchrone. La valeur par défaut est true. |
| beforeSend(xhr) | Une fonction à exécuter avant l'envoi de la requête. |
| cache | Une valeur booléenne indiquant si le navigateur met en cache la page demandée. La valeur par défaut est true. |
| complete(xhr,status) | Une fonction à exécuter lorsque la requête se termine (appelée après les fonctions success et error, c'est-à-dire après les fonctions success et error). |
| contentType | Le type de contenu utilisé lors de l'envoi de données au serveur. Par défaut : "application/x-www-form-urlencoded". |
| context | Spécifie la valeur de "this" pour toutes les fonctions de rappel liées à AJAX. |
| data | Spécifie les données à envoyer au serveur. |
| dataFilter(data,type) | Une fonction pour traiter les données de réponse brutes de XMLHttpRequest. |
| dataType | Le type de données attendu de la réponse du serveur. |
| error(xhr,status,error) | Une fonction à exécuter si la requête échoue. |
| global | Une valeur booléenne indiquant s'il faut déclencher les gestionnaires d'événements AJAX globaux pour la requête. La valeur par défaut est true. |
| ifModified | Une valeur booléenne indiquant si la requête n'est réussie que si la réponse a changé depuis la dernière requête. La valeur par défaut est false. |
| jsonp | Une chaîne pour remplacer la fonction de rappel dans un jsonp. |
| jsonpCallback | Spécifie le nom de la fonction de rappel dans un jsonp. |
| mot de passe | Spécifie le mot de passe à utiliser dans une requête d'authentification d'accès HTTP. |
| processData | Une valeur booléenne indiquant si les données envoyées via la requête sont converties en chaîne de requête. La valeur par défaut est true. |
| scriptCharset | Spécifie le jeu de caractères pour la requête. |
| success(result,status,xhr) | Une fonction à exécuter lorsque la requête réussit. |
| timeout | Définit le délai d'attente local de la requête (en millisecondes). |
| traditionnel | Une valeur booléenne spécifiant s'il faut utiliser le style traditionnel de sérialisation des paramètres. |
| type | Spécifie le type de requête (GET ou POST). |
| url | Spécifie l'URL à laquelle envoyer la requête. La valeur par défaut est la page actuelle. |
| username | Spécifie le nom d'utilisateur à utiliser dans une requête d'authentification d'accès HTTP. |
| xhr | Une fonction pour créer l'objet XMLHttpRequest. |
Plus d’exemples
Créer une requête AJAX asynchrone
Comment utiliser le paramètre async pour spécifier une requête asynchrone.
Créer une requête AJAX avec un type de données spécifié
Comment utiliser le paramètre dataType pour spécifier le type de données de la requête.
Créer une requête AJAX avec des erreurs
Comment utiliser le paramètre error pour gérer les erreurs dans les requêtes AJAX.
Autres extensions
Méthodes AJAX jQuery