Cet article parle principalement de la structure grammaticale de base de ajax, avec des exemples pour que chacun puisse apprendre plus clairement. Jetons maintenant un œil à cet article
Modèle de code :
$.ajax({
type: "POST",
url: "/login",
contentType: 'application/x-www-form-urlencoded;charset=utf-8',
data: {username:$("#username").val(), password:$("#password").val()},
dataType: "json",
success: function(data){
console.log(data);
}，
error:function(e){
console.log(e);
}
})options
Type : Objet
Facultatif. Paramètres de requête AJAX. Toutes les options sont facultatives.
async
Type : Booléen
Valeur par défaut : vrai. Par défaut, toutes les requêtes sont asynchrones. Si vous devez envoyer des requêtes synchrones, définissez cette option sur false.
Notez que les requêtes synchrones verrouillent le navigateur et que les autres opérations utilisateur doivent attendre que la requête soit terminée avant de pouvoir être exécutées.
beforeSend(XHR)
Type : Fonction
Une fonction qui peut modifier l'objet XMLHttpRequest avant d'envoyer la requête, comme l'ajout d'en-têtes HTTP auto-définis.
L'objet XMLHttpRequest est le seul paramètre.
C'est un événement de l'Ajax. Si false est renvoyé, cette requête ajax peut être annulée.
cache
Type : Booléen
Valeur par défaut : vrai, la valeur par défaut est fausse lorsque dataType est script et jsonp. Définissez sur false pour ne pas mettre cette page en cache.
Nouvelles fonctionnalités dans jQuery 1.2.
complete(XHR, TS)
Type : Fonction
Fonction de rappel une fois la demande terminée (après la demande est réussi ou échoué) sont appelés).
Paramètres : objet XMLHttpRequest et une chaîne décrivant le type de requête.
C'est un événement de l'Ajax.
contentType
Type : String
Valeur par défaut : "application/x-www-form-urlencoded". Type d'encodage du contenu lors de l'envoi d'informations au serveur.
La valeur par défaut convient à la plupart des situations. Si vous transmettez explicitement un type de contenu à $.ajax() alors il sera définitivement envoyé au serveur (même s'il n'y a aucune donnée à envoyer).
context
Type : Objet
Cet objet est utilisé pour définir le contexte des fonctions de rappel liées à Ajax. En d'autres termes, laissez ceci dans la fonction de rappel pointer vers cet objet (si ce paramètre n'est pas défini, alors cela pointera vers le paramètre options passé lors de l'appel de cette requête AJAX). Par exemple, spécifier un élément DOM comme paramètre de contexte définira le contexte de la fonction de rappel de réussite sur cet élément DOM.
Juste comme ceci :
$.ajax({ url: "test.html", context: document.body, success: function(){
$(this).addClass("done");
}});(Si vous voulez en voir plus, rendez-vous sur le site Web PHP chinois Colonne Manuel de développement AJAX pour learn)
données
Type : Chaîne
Données envoyées au serveur. Sera automatiquement converti au format de chaîne de demande. Ajouté à l'URL dans les requêtes GET. Voir la description de l'option processData pour désactiver cette conversion automatique. Doit être au format Clé/Valeur. S'il s'agit d'un tableau, jQuery attribuera automatiquement le même nom à différentes valeurs. Par exemple, {foo:["bar1", "bar2"]} est converti en '&foo=bar1&foo=bar2'.
dataFilter
Type : Fonction
Une fonction pour prétraiter les données originales renvoyées par Ajax. Fournissez deux paramètres, data et type : data sont les données d'origine renvoyées par Ajax et type est le paramètre dataType fourni lors de l'appel de jQuery.ajax. La valeur renvoyée par la fonction sera ensuite traitée par jQuery.
dataType
Type : String
Le type de données qui devrait être renvoyé par le serveur. S'il n'est pas spécifié, jQuery effectuera automatiquement des jugements intelligents basés sur les informations MIME du package HTTP. Par exemple, le type XML MIME est reconnu comme XML. Dans la version 1.4, JSON générera un objet JavaScript et le script exécutera le script. Les données renvoyées par le serveur seront ensuite analysées en fonction de cette valeur et transmises à la fonction de rappel. Valeurs disponibles :
"xml" : renvoie un document XML pouvant être traité avec jQuery.
"html" : renvoie les informations HTML en texte brut ; la balise de script incluse sera exécutée une fois insérée dans le dom.
"script" : renvoie le code JavaScript en texte brut. Les résultats ne sont pas automatiquement mis en cache. Sauf si le paramètre "cache" est défini. Remarque : lors de requêtes distantes (pas sous le même domaine), toutes les requêtes POST seront converties en requêtes GET. (Car la balise de script DOM sera utilisée pour le chargement)
"json" : renvoie les données JSON.
"jsonp" : format JSONP. Lors de l'appel d'une fonction au format JSONP, telle que "myurl?callback=?", jQuery remplacera automatiquement ? par le nom de fonction correct pour exécuter la fonction de rappel.
"text": Renvoie une chaîne de texte brut
error
Type： Fonction
Valeur par défaut : jugement automatique (xml ou html). Cette fonction est appelée lorsque la requête échoue.
a les trois paramètres suivants : objet XMLHttpRequest, message d'erreur et (facultatif) objet d'exception capturé.
Si une erreur se produit, le message d'erreur (le deuxième paramètre) peut être "timeout", "error", "notmodified" et "parsererror" en plus de null.
C'est un événement de l'Ajax.
global
Type : Booléen
S'il faut déclencher l'événement AJAX global. Valeur par défaut : vrai. La définition sur false ne déclenchera pas d'événements AJAX globaux tels que ajaxStart ou ajaxStop qui peuvent être utilisés pour contrôler différents événements Ajax.
ifModified
Type : Booléen
Obtient de nouvelles données uniquement lorsque les données du serveur changent. Valeur par défaut : faux. Utilisez les informations d’en-tête Last-Modified du paquet HTTP pour le déterminer. Depuis jQuery 1.4, il vérifie également le « etag » spécifié par le serveur pour s'assurer que les données n'ont pas été modifiées.
jsonp
Type : String
Réécrivez le nom de la fonction de rappel dans une requête jsonp. Cette valeur est utilisée pour remplacer la partie "callback" du paramètre URL dans une requête GET ou POST telle que {jsonp:'onJsonPLoad'} qui entraînera la transmission de "onJsonPLoad=?"
jsonpCallback
Type : String
Spécifiez un nom de fonction de rappel pour la requête jsonp. Cette valeur sera utilisée à la place du nom de fonction aléatoire généré automatiquement par jQuery. Ceci est principalement utilisé pour permettre à jQuery de générer des noms de fonctions uniques afin de faciliter la gestion des requêtes et de fournir des fonctions de rappel et de gestion des erreurs. Vous pouvez également spécifier ce nom de fonction de rappel lorsque vous souhaitez que le navigateur mette en cache les requêtes GET.
mot de passe
Type : Chaîne
Mot de passe utilisé pour répondre à la demande d'authentification d'accès HTTP
processData
Type : Booléen
Valeur par défaut : vrai. Par défaut, les données transmises via l'option data, s'il s'agit d'un objet (techniquement parlant, tant qu'il ne s'agit pas d'une chaîne), seront traitées et converties en chaîne de requête pour correspondre au type de contenu par défaut "application/x -www-form-urlencoded" ". Définissez sur false si vous souhaitez envoyer des informations sur l'arborescence DOM ou d'autres informations que vous ne souhaitez pas convertir.
scriptCharset
Type : String
Uniquement lorsque le dataType demandé est "jsonp" ou "script", et tapez uniquement "GET" sera utilisé pour forcer la modification du jeu de caractères. Généralement utilisé uniquement lorsque les encodages de contenu local et distant sont différents.
succès
Type : Fonction
Fonction de rappel une fois la demande réussie.
Paramètre : Données renvoyées par le serveur et traitées selon le paramètre dataType ; une chaîne décrivant le statut.
C'est un événement de l'Ajax.
traditionnel
Type : Booléen
Si vous souhaitez sérialiser les données de manière traditionnelle, alors set est vrai. Veuillez vous référer à la méthode jQuery.param dans la catégorie Outils.
timeout
Type : Nombre
Définissez le délai d'expiration de la demande (millisecondes). Ce paramètre remplace le paramètre global.
taper
Type : Chaîne
Par défaut : "GET"). Méthode de requête ("POST" ou "GET"), la valeur par défaut est "GET". Remarque : D'autres méthodes de requête HTTP telles que PUT et DELETE peuvent également être utilisées, mais ne sont prises en charge que par certains navigateurs.
url
Type : Chaîne
Valeur par défaut : Adresse de la page actuelle. L'adresse à laquelle envoyer la demande.
nom d'utilisateur
Type : Chaîne
Nom d'utilisateur utilisé pour répondre aux demandes d'authentification d'accès HTTP.
xhr
Type : Fonction
Nécessite de renvoyer un objet XMLHttpRequest. La valeur par défaut est ActiveXObject sous IE et XMLHttpRequest sinon. Utilisé pour remplacer ou fournir un objet XMLHttpRequest amélioré. Ce paramètre n'était pas disponible avant jQuery 1.3.
Si vous souhaitez traiter les données obtenues par $.ajax(), vous devez utiliser la fonction de rappel : beforeSend, error, dataFilter, success , complet.
est appelé avant d'envoyer la requête et transmet un XMLHttpRequest en tant que paramètre.
est appelée lorsqu'une erreur de requête se produit. En transmettant l'objet XMLHttpRequest, une chaîne décrivant le type d'erreur et un objet d'exception (le cas échéant)
est appelé une fois la requête réussie. Transmettez les données renvoyées et la valeur du paramètre "dataType". Et doit renvoyer de nouvelles données (éventuellement traitées) transmises à la fonction de rappel de réussite.
Appelé après demande. Transmettez les données renvoyées et une chaîne contenant le code de réussite.
Cette fonction est appelée lorsque la requête est terminée, quel que soit le succès ou l'échec. Transmettez l'objet XMLHttpRequest et une chaîne contenant un code de réussite ou d'erreur. La fonction
$.ajax() s'appuie sur les informations fournies par le serveur pour traiter les données renvoyées. Si le serveur signale que les données renvoyées sont XML, les résultats renvoyés peuvent être itérés à l'aide de méthodes XML normales ou de sélecteurs jQuery. Si d'autres types sont visibles, tels que HTML, les données sont traitées comme du texte.
Vous pouvez également spécifier d'autres méthodes de traitement des données via l'option dataType. En plus du XML simple, vous pouvez également spécifier du HTML, json, jsonp, un script ou du texte.
Parmi eux, les données renvoyées par les types texte et xml ne seront pas traitées. Les données transmettent simplement l'attribut ResponseText ou ResponseHTML de XMLHttpRequest à la fonction de rappel de réussite.
Remarque : Nous devons nous assurer que le type MIME signalé par le serveur Web correspond au type de données que nous avons sélectionné. Par exemple, dans le cas de XML, le serveur doit déclarer text/xml ou application/xml pour obtenir des résultats cohérents.
S'il est spécifié comme type HTML, tout JavaScript intégré sera exécuté avant que le HTML ne soit renvoyé sous forme de chaîne. De même, si le type de script est spécifié, le JavaScript généré côté serveur sera exécuté en premier, puis le script sera renvoyé sous forme de données texte.
Si elles sont spécifiées comme type json, les données obtenues seront analysées comme un objet JavaScript et l'objet construit sera renvoyé comme résultat. Pour y parvenir, il tente d’abord d’utiliser JSON.parse(). Si le navigateur ne le prend pas en charge, une fonction est utilisée pour le construire.
Les données JSON sont une sorte de données structurées qui peuvent être facilement analysées via JavaScript. Si le fichier de données obtenu est stocké sur un serveur distant (avec des noms de domaine différents, c'est-à-dire une acquisition de données inter-domaines), vous devez utiliser le type jsonp. L'utilisation de ce type crée un paramètre de chaîne de requête callback=? qui est ajouté à l'URL demandée. Le serveur doit ajouter le nom de la fonction de rappel avant les données JSON afin de compléter une requête JSONP valide. Si vous souhaitez spécifier le nom du paramètre de la fonction de rappel au lieu du rappel par défaut, vous pouvez définir le paramètre jsonp de $.ajax().
Remarque : JSONP est une extension du format JSON. Il nécessite du code côté serveur pour détecter et gérer les paramètres de chaîne de requête.
Si le type script ou jsonp est spécifié, alors lorsque les données sont reçues du serveur, la balise
![[Web front-end] Démarrage rapide de Node.js](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
