Blob: textStream()-Methode
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die textStream()-Methode der Schnittstelle Blob gibt einen ReadableStream zurück, der verwendet werden kann, um den Inhalt des Blob in UTF-8-Chunks zu lesen.
Dies bietet einen einfacheren Mechanismus zum Streamen des Inhalts, als einen Byte-Stream von Blob.stream() durch einen TextDecoderStream zu leiten.
Hinweis:
Die Methode textStream() unterscheidet sich von FileReader.readAsText() dadurch, dass sie immer die UTF-8-Kodierung verwendet, während readAsText() einen Parameter besitzt, der die Kodierung festlegt.
Syntax
textStream()
Parameter
Keine.
Rückgabewert
Ein ReadableStream.
Beispiele
Blob-Inhalt als Text-Stream lesen
Dieses Beispiel zeigt, wie Blob-Inhalt als Text-Stream gelesen wird.
Wir erstellen einen Beispiel-Blob, rufen mithilfe von textStream() einen ReadableStream seines Inhalts ab und lesen dann den Text über einen Reader, der mit ReadableStream.getReader() erstellt wurde.
const pElem = document.querySelector("p");
const obj = { hello: "world" };
const myBlob = new Blob([JSON.stringify(obj, null, 2)], {
type: "application/json",
});
async function streamBlobText(blob) {
const textStream = blob.textStream();
// instead of
// const textStream = blob.stream().pipeThrough(new TextDecoderStream());
const reader = textStream.getReader();
while (true) {
const { value, done } = await reader.read();
if (done) break;
pElem.textContent += value;
}
}
streamBlobText(myBlob);
Spezifikationen
| Spezifikation |
|---|
| File API # dom-blob-textstream |