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
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:
- Der Antwortkörper ist gestört oder gesperrt.
- Es gab einen Fehler beim Dekodieren des Körperinhalts (zum Beispiel, weil der
Content-Encoding
-Header falsch ist).
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.
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