XMLHttpRequest : propriété response
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
Note : Cette fonctionnalité est disponible via les Web Workers, sauf pour les Service Workers.
La propriété en lecture seule response de l'interface XMLHttpRequest retourne le contenu du corps de la réponse sous forme de ArrayBuffer, de Blob, de Document, d'un Object JavaScript ou d'une chaîne de caractères, en fonction de la valeur de la propriété responseType de la requête.
Valeur
Un objet approprié en fonction de la valeur de responseType.
Vous pouvez tenter de demander que les données soient fournies dans un format spécifique en définissant la valeur de responseType après avoir appelé open() pour initialiser la requête, mais avant d'appeler send() pour envoyer la requête au serveur.
La valeur est null si la requête n'est pas encore terminée ou a échoué, à l'exception du cas où l'on lit des données textuelles en utilisant un responseType de "text" ou la chaîne de caractères vide (""), la réponse peut contenir la réponse partielle tant que la requête est encore dans l'état readyState LOADING (3).
Exemples
Cet exemple présente une fonction, charger(), qui charge et traite une page depuis le serveur. Elle fonctionne en créant un objet XMLHttpRequest et en créant un écouteur pour les évènements readystatechange de sorte que lorsque readyState passe à DONE (4), la response est obtenue et transmise à la fonction de rappel fournie à charger().
Le contenu est traité comme des données textuelles brutes (puisque rien ici ne remplace la valeur par défaut de responseType).
const url = "unePage.html"; // Une page locale
function charger(url, fonctionRappel) {
const xhr = new XMLHttpRequest();
xhr.onreadystatechange = () => {
if (xhr.readyState === 4) {
fonctionRappel(xhr.response);
}
};
xhr.open("GET", url, true);
xhr.send("");
}
Spécifications
| Spécification |
|---|
| XMLHttpRequest # the-response-attribute |
Compatibilité des navigateurs
Voir aussi
- Utiliser XMLHttpRequest
- Obtenir du texte et des données HTML/XML :
XMLHttpRequest.responseTextetXMLHttpRequest.responseXML