Antwort: 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
text()
Parameter
Keine.
Rückgabewert
Ein Promise, das mit einem String
aufgelöst wird.
Ausnahmen
DOMException
AbortError
-
Die Anfrage wurde abgebrochen.
TypeError
-
Ausgelöst aus einem der folgenden Gründe:
- Der Antwort-Body ist gestört oder gesperrt.
- Es gab einen Fehler beim Dekodieren des Body-Inhalts (zum Beispiel, weil der
Content-Encoding
-Header falsch ist).
Beispiele
In unserem fetch text example (laufen Sie fetch text live), haben wir ein <article>
-Element und drei Links (gespeichert im myLinks
Array).
Zuerst durchlaufen wir alle diese und geben jedem einen onclick
-Event-Handler, so dass die getData()
Funktion ausgeführt wird — mit dem data-page
-Identifier des Links als Argument — 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 bestimmte .txt
Datei abzurufen.
Wenn das Fetch erfolgreich ist, lesen wir einen String aus der Antwort mit text()
, und setzen dann die innerText
des <article>
-Elements gleich dem Textobjekt.
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① |