XMLHttpRequest : propriété responseXML
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 responseXML de l'interface XMLHttpRequest retourne un Document contenant le HTML ou le XML récupéré par la requête ; ou null si la requête a échoué, n'a pas encore été envoyée, ou si les données ne peuvent pas être analysées en tant que XML ou HTML.
Note :
Le nom responseXML est un vestige de l'historique de cette propriété ; il fonctionne à la fois pour le HTML et le XML.
Généralement, la réponse est analysée comme "text/xml". Si la responseType est définie sur "document" et que la requête a été effectuée de manière asynchrone, la réponse est alors analysée comme "text/html". responseXML est null pour tout autre type de données, ainsi que pour les URL data:.
Si le serveur ne définit pas l'en-tête Content-Type comme "text/xml" ou "application/xml", vous pouvez utiliser XMLHttpRequest.overrideMimeType() pour l'analyser comme XML de toute façon.
Cette propriété n'est pas disponible pour les workers.
Valeur
Un objet Document obtenu en analysant le XML ou le HTML reçu à l'aide de XMLHttpRequest, ou null si aucune donnée n'a été reçue ou si les données ne sont pas au format XML/HTML.
Exceptions
InvalidStateErrorDOMException-
Levée si la
responseTypen'est nidocumentni une chaîne de caractères vide.
Exemples
const xhr = new XMLHttpRequest();
xhr.open("GET", "/server");
// Si défini, responseType doit être une chaîne de caractères vide ou « document »
xhr.responseType = "document";
// Force la réponse à être analysée comme XML
xhr.overrideMimeType("text/xml");
xhr.onload = () => {
if (xhr.readyState === xhr.DONE && xhr.status === 200) {
console.log(xhr.response, xhr.responseXML);
}
};
xhr.send();
Spécifications
| Spécification |
|---|
| XMLHttpRequest # the-responsexml-attribute |
Compatibilité des navigateurs
Voir aussi
- L'interface
XMLHttpRequest - La propriété
XMLHttpRequest.response - La propriété
XMLHttpRequest.responseType - Analyser et sérialiser le XML
- Analyser le XML en un arbre DOM :
DOMParser - Sérialiser un arbre DOM en XML :
XMLSerializer(plus précisément, la méthodeserializeToString())