XMLHttpRequest : propriété responseText
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 responseText de l'interface XMLHttpRequest retourne le texte reçu d'un serveur suite à l'envoi d'une requête.
Valeur
Une chaîne de caractères contenant soit les données textuelles reçues à l'aide de
XMLHttpRequest, soit "" si la requête a échoué ou si aucun contenu n'a encore été reçu.
Lors du traitement d'une requête asynchrone, la valeur de responseText contient toujours le contenu actuel reçu du serveur, même s'il est incomplet parce que les données n'ont pas encore été entièrement reçues.
Vous savez que l'intégralité du contenu a été reçue lorsque la valeur de readyState devient XMLHttpRequest.DONE (4), et que status devient 200 ("OK").
Exceptions
InvalidStateErrorDOMException-
Levée si le type de réponse (
XMLHttpRequest.responseType) n'est pas défini sur la chaîne de caractères vide ou"text". Comme la propriétéresponseTextn'est valide que pour le contenu textuel, toute autre valeur constitue une condition d'erreur.
Exemples
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server", true);
// Si défini, responseType doit être la chaîne de caractères vide ou « text »
xhr.responseType = "text";
xhr.onload = () => {
if (xhr.readyState === xhr.DONE) {
if (xhr.status === 200) {
console.log(xhr.response);
console.log(xhr.responseText);
}
}
};
xhr.send(null);
Spécifications
| Spécification |
|---|
| XMLHttpRequest # the-responsetext-attribute |