Response: `text()`-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die text()-Methode des Response-Interfaces nimmt einen Response-Stream und liest ihn vollständig aus. Sie gibt ein Promise zurück, das mit einem String aufgelöst wird. Die Antwort wird immer mit UTF-8 dekodiert.

Syntax

js
text()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einem String aufgelöst wird.

Ausnahmen

DOMException AbortError

Die Anfrage wurde abgebrochen.

TypeError

Wird aus einem der folgenden Gründe ausgelöst:

Beispiele

In unserem Textabruf-Beispiel (führen Sie den Textabruf live aus) haben wir ein <article>-Element und drei Links (gespeichert im myLinks-Array). Zuerst durchlaufen wir alle diese und geben jedem einen onclick-Ereignishandler, sodass die getData()-Funktion ausgeführt wird – mit dem data-page-Identifier des Links, der als Argument übergeben wird – wenn einer der Links angeklickt wird.

Wenn getData() ausgeführt wird, erstellen wir eine neue Anfrage mit dem Request()-Konstruktor und verwenden sie, um eine spezifische .txt-Datei abzurufen. Wenn der Abruf erfolgreich ist, lesen wir einen String aus der Antwort mit text() aus und setzen dann die innerText des <article>-Elements gleich dem Textobjekt.

js
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) => response.text())
    .then((text) => {
      myArticle.innerText = text;
    });
}

Spezifikationen

Specification
Fetch Standard
# ref-for-dom-body-text①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch