Back to Content

Response: statusText property

files/en-us/web/api/response/statustext/index.md

latest2.0 KB
Original Source

{{APIRef("Fetch API")}}{{AvailableInWorkers}}

The statusText read-only property of the {{domxref("Response")}} interface contains the status message corresponding to the HTTP status code in {{domxref("Response.status")}}.

For example, this would be OK for a status code 200, Continue for 100, Not Found for 404.

Value

A {{jsxref("String")}} containing the HTTP status message associated with the response. The default value is "".

See HTTP response status codes for a list of codes and their associated status messages. Note that HTTP/2 does not support status messages.

Examples

In our Fetch Response example (see Fetch Response live) we create a new {{domxref("Request")}} object using the {{domxref("Request.Request","Request()")}} constructor, passing it a JPG path. We then fetch this request using {{domxref("Window/fetch", "fetch()")}}, extract a blob from the response using {{domxref("Response.blob")}}, create an object URL out of it using {{domxref("URL.createObjectURL_static", "URL.createObjectURL()")}}, and display this in an {{htmlelement("img")}}.

Note that at the top of the fetch() block we log the response statusText value to the console.

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

const myRequest = new Request("flowers.jpg");

fetch(myRequest)
  .then((response) => {
    console.log("response.statusText =", response.statusText); // response.statusText = "OK"
    return response.blob();
  })
  .then((myBlob) => {
    const objectURL = URL.createObjectURL(myBlob);
    myImage.src = objectURL;
  });

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also