XMLHttpRequest : propriété statusText
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 statusText de l'interface XMLHttpRequest retourne une chaîne de caractères contenant le message d'état de la réponse tel que retourné par le serveur HTTP. Contrairement à XMLHttpRequest.status qui indique un code d'état numérique, cette propriété contient le texte de l'état de la réponse, tel que « OK » ou « Not Found ». Si l'état readyState de la requête est UNSENT ou OPENED, la valeur de statusText est une chaîne de caractères vide.
Si la réponse du serveur ne définit pas explicitement un texte d'état, statusText prend la valeur par défaut « OK ».
Note : Les réponses sur une connexion HTTP/2 ont toujours une chaîne de caractères vide comme message d'état, car HTTP/2 ne les prend pas en charge.
Valeur
Une chaîne de caractères.
Exemples
const xhr = new XMLHttpRequest();
console.log("0 UNSENT", xhr.statusText);
xhr.open("GET", "/server", true);
console.log("1 OPENED", xhr.statusText);
xhr.onprogress = () => {
console.log("3 LOADING", xhr.statusText);
};
xhr.onload = () => {
console.log("4 DONE", xhr.statusText);
};
xhr.send(null);
/**
* Affiche les valeurs suivantes :
*
* 0 UNSENT
* 1 OPENED
* 3 LOADING OK
* 4 DONE OK
*/
Spécifications
| Spécification |
|---|
| XMLHttpRequest # the-statustext-attribute |