XMLHttpRequest : méthode getResponseHeader()
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 méthode getResponseHeader() de l'interface XMLHttpRequest retourne la chaîne de caractères contenant le texte de la valeur d'un en-tête particulier.
Si plusieurs en-têtes de réponse ont le même nom, leurs valeurs sont retournées sous forme d'une seule chaîne de caractères concaténée, chaque valeur étant séparée de la précédente par une paire de virgule et d'espace. La méthode getResponseHeader() retourne la valeur sous forme de séquence d'octets UTF.
Note : La recherche du nom de l'en-tête est insensible à la casse.
Si vous avez besoin d'obtenir la chaîne de caractères brute de tous les en-têtes, utilisez la méthode getAllResponseHeaders(), qui retourne l'intégralité de la chaîne de caractères d'en-têtes brute.
Syntaxe
getResponseHeader(headerName)
Paramètres
headerName-
Une chaîne de caractères indiquant le nom de l'en-tête dont vous souhaitez obtenir la valeur sous forme de texte.
Valeur de retour
Une chaîne de caractères représentant la valeur de l'en-tête sous forme de texte, ou null si la réponse n'a pas encore été reçue ou si l'en-tête n'existe pas dans la réponse.
Exemples
Dans cet exemple, une requête est créée et envoyée, et un gestionnaire pour l'évènement readystatechange est établi pour vérifier le readyState afin d'indiquer que les en-têtes ont été reçus ; lorsque c'est le cas, la valeur de l'en-tête Content-Type est récupérée. Si le Content-Type n'est pas la valeur souhaitée, la requête XMLHttpRequest est annulée en appelant abort().
const client = new XMLHttpRequest();
client.open("GET", "les-licornes-sont-geniales.txt", true);
client.send();
client.onreadystatechange = () => {
if (client.readyState === client.HEADERS_RECEIVED) {
const typeContenu = client.getResponseHeader("Content-Type");
if (typeContenu !== monTypeAttendu) {
client.abort();
}
}
};
Spécifications
| Spécification |
|---|
| XMLHttpRequest # dom-xmlhttprequest-getresponseheader |
Compatibilité des navigateurs
Voir aussi
- Utiliser XMLHttpRequest
- Les en-têtes HTTP
- La méthode
getAllResponseHeaders() - La propriété
response - Définir les en-têtes de requête :
setRequestHeader()