English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
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().
$.ajaxSetup({name:value, name:value, ...})
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.
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 :
Nom | Type de valeur | Description |
---|---|---|
async | Booléen | Un booléen indiquant si la requête doit être traitée de manière asynchrone. La valeur par défaut est true |
beforeSend(xhr) | Fonction | Fonction exécutée avant l'envoi de la requête |
cache | Booléen | Un 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) | Fonction | Fonction exécutée après la fin de la requête (après les fonctions de succès et d'erreur) |
contentType | Booléen ou chaîne | Type de contenu utilisé pour envoyer les données au serveur. La valeur par défaut est 'application' / x-www-form-urlencoded |
context | Objet normal | Spécifie la valeur de 'this' pour toutes les fonctions de rappel AJAX |
data | Objet de type PlainObject ou String ou Array | Spécifie les données à envoyer au serveur |
dataFilter(data,type) | Fonction | Fonction utilisée pour traiter les données originales de la réponse XMLHttpRequest |
dataType | Chaîne | Type de données attendu dans la réponse du serveur |
error(xhr,status,error) | Fonction | Fonction exécutée lorsque la requête échoue |
global | Booléen | Un booléen indiquant si le gestionnaire d'événements AJAX global doit être déclenché. La valeur par défaut est true |
ifModified | Booléen | Un 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 |
jsonp | Chaîne ou booléen | Remplace la fonction de rappel jsonp dans la requête |
jsonpCallback | Fonction | Spécifie le nom de la fonction de rappel pour la requête jsonp |
method | Chaîne | Spécifie la méthode HTTP à utiliser pour la requête (obtenir ou publier). La valeur par défaut est GET |
password | Chaîne | Spécifie le mot de passe utilisé pour l'authentification HTTP. Par défaut, c'est password |
processData | Booléen | Un 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 |
scriptCharset | Chaîne | Spécifiez le jeu de caractères pour la requête |
statusCode | Objet normal | Objet 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) | Fonction | Fonction à exécuter lors d'une réponse réussie |
timeout | Numérique | Délai d'attente local de la requête (en millisecondes) |
traditional | Booléen | Un booléen, indiquant si un style de sérialisation de paramètres traditionnel doit être utilisé |
type | Chaîne | methodAlias. Si vous utilisez1.9Pour les versions de jQuery avant .0, utilisez type |
url | Chaîne | Spécifiez l'URL vers laquelle la requête doit être envoyée. Par défaut, c'est la page actuelle |
username | Chaîne | Spécifiez le nom d'utilisateur à utiliser pour les demandes d'authentification HTTP |
xhr | Fonction | Fonction utilisée pour créer des objets XMLHttpRequest |