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
# ref-for-dom-body-text①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
text

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch