jQuery ajaxSetup()Méthode
Méthodes AJAX jQueryExemples
Définir l'URL et la fonction de succès par défaut pour toutes les requêtes AJAX :
$("button").click(function(){
$.ajaxSetup({
url:"demo_ajax_load.txt",
success:function(result){
$("div").html(result);
}
});
$.ajax();
});
Essayez-le vous-même »
Définition et utilisation
La méthode ajaxSetup() définit les valeurs par défaut pour les futures requêtes AJAX.
Syntaxe
$.ajaxSetup({name:value, name:value, ... })
Ce paramètre définit les réglages des requêtes AJAX avec une ou plusieurs paires nom/valeur.
Le tableau ci-dessous liste 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 les pages demandées. La valeur par défaut est true. |
| complete(xhr,status) | Une fonction à exécuter lorsque la requête est terminée (appelée après la réussite ou l'échec de la requête, 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 utilisée pour traiter les données de réponse brutes d'une 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 spécifiant 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 spécifiant si la requête ne doit être considérée comme 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 spécifiant si les données envoyées avec 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 un objet XMLHttpRequest. |
Plus d’exemples
Spécifier le gestionnaire d'erreurs pour les requêtes AJAX
Comment utiliser le paramètre error pour spécifier le gestionnaire d'erreurs pour les requêtes AJAX.
Autres extensions