Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Response : propriété statusText

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2017.

Note : Cette fonctionnalité est disponible via les Web Workers.

La propriété en lecture seule statusText de l'interface Response contient le message de statut correspondant au code d'état HTTP dans Response.status.

Par exemple, cela sera OK pour un code d'état 200, Continue pour 100, Not Found pour 404.

Valeur

Une String contenant le message de statut HTTP associé à la réponse. La valeur par défaut est "".

Voir codes d'état de réponse HTTP pour une liste des codes et de leurs messages de statut associés. Notez que HTTP/2 ne prend pas en charge les messages de statut.

Exemples

Dans notre exemple Fetch Response (angl.) (voir l'exécution en direct (angl.)), nous créons un nouvel objet Request à l'aide du constructeur Request(), en lui passant le chemin d'un fichier JPG. Nous utilisons ensuite fetch() pour effectuer la requête, extrayons un blob de la réponse avec Response.blob, créons une URL objet avec URL.createObjectURL(), et affichons cela dans une <img>.

Notez qu'au début du bloc fetch(), nous enregistrons la valeur de statusText de la réponse dans la console.

js
const monImage = document.querySelector("img");

const maRequete = new Request("fleurs.jpg");

fetch(maRequete)
  .then((reponse) => {
    console.log("reponse.statusText =", reponse.statusText); // reponse.statusText = "OK"
    return reponse.blob();
  })
  .then((monBlob) => {
    const objectURL = URL.createObjectURL(monBlob);
    monImage.src = objectURL;
  });

Spécifications

Specification
Fetch
# ref-for-dom-response-statustext①

Compatibilité des navigateurs

Voir aussi