Thetext() method of theResponse interface takes aResponse stream and reads it to completion.It returns a promise that resolves with aString.The response isalways decoded using UTF-8.

Syntax

text()

Parameters

None.

Return value

A Promise that resolves with aString.

Exceptions

AbortErrorDOMException

The request wasaborted.

TypeError

Thrown for one of the following reasons:

• The response body isdisturbed or locked.
• There was an error decoding the body content (for example, because theContent-Encoding header is incorrect).

Examples

In ourfetch text example (runfetch text live), we have an<article> element and three links (stored in themyLinks array.)First, we loop through all of these and give each one anonclick event handler so that thegetData() function is run — with the link'sdata-page identifier passed to it as an argument — when one of the links is clicked.

WhengetData() is run, we create a new request using theRequest() constructor, then use it to fetch a specific.txt file.When the fetch is successful, we read a string out of the response usingtext(), then set theinnerText of the<article> element equal to the text object.

const myArticle = document.querySelector("article");const myLinks = document.querySelectorAll("ul a");for (const link of myLinks) {  link.onclick = (e) => {    e.preventDefault();    const linkData = e.target.getAttribute("data-page");    getData(linkData);  };}function getData(pageId) {  console.log(pageId);  const myRequest = new Request(`${pageId}.txt`);  fetch(myRequest)    .then((response) => {      if (!response.ok) {        throw new Error(`HTTP error, status = ${response.status}`);      }      return response.text();    })    .then((text) => {      myArticle.innerText = text;    })    .catch((error) => {      myArticle.innerText = `Error: ${error.message}`;    });}

Specifications

Browser compatibility

See also

• ServiceWorker API
• HTTP access control (CORS)
• HTTP