Baseline Widely available
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die getReader()
-Methode der ReadableStream
-Schnittstelle erstellt einen Reader und sperrt den Stream für diesen. Solange der Stream gesperrt ist, kann kein anderer Reader erworben werden, bis dieser freigegeben wird.
getReader()
getReader(options)
Parameter
options
Optional
Ein Objekt, das die folgenden Eigenschaften enthält:
mode
Optional
Eine Eigenschaft, die den Typ des zu erstellenden Readers angibt. Mögliche Werte sind:
"byob"
, was die Erstellung eines ReadableStreamBYOBReader
zur Folge hat, der lesbare Byte-Streams lesen kann (Streams, die eine Zero-Copy-Ãbertragung von einer zugrunde liegenden Byte-Quelle zum Reader unterstützen, wenn interne Stream-Puffer leer sind).undefined
(oder gar nicht angegeben â dies ist der Standardwert), was die Erstellung eines ReadableStreamDefaultReader
zur Folge hat, der einzelne Chunks aus einem Stream lesen kann.Eine Instanz eines ReadableStreamDefaultReader
oder ReadableStreamBYOBReader
-Objekts, abhängig vom Wert des mode
.
RangeError
Wird geworfen, wenn der angegebene mode
-Wert nicht "byob"
oder undefined
ist.
TypeError
Wird geworfen, wenn der Stream, für den Sie versuchen, einen Reader zu erstellen, bereits gesperrt ist oder nicht ein ReadableStream
ist. Dies wird auch geworfen, wenn ein BYOB-Reader angefordert wird und der Stream-Controller kein ReadableByteStreamController
ist (der Stream wurde nicht als zugrunde liegende Quelle mit type="bytes"
konstruiert).
Im folgenden einfachen Beispiel wird ein zuvor erstellter benutzerdefinierter ReadableStream
mit einem mit getReader()
erstellten ReadableStreamDefaultReader
gelesen. (siehe unser Beispiel für einen einfachen zufälligen Stream für den vollständigen Code). Jeder Chunk wird nacheinander gelesen und in die Benutzeroberfläche ausgegeben, bis der Stream vollständig gelesen wurde. Zu diesem Zeitpunkt verlassen wir die rekursive Funktion und geben den gesamten Stream an einem anderen Teil der Benutzeroberfläche aus.
function fetchStream() {
const reader = stream.getReader();
let charsReceived = 0;
// read() returns a promise that resolves
// when a value has been received
reader.read().then(function processText({ done, value }) {
// Result objects contain two properties:
// done - true if the stream has already given you all its data.
// value - some data. Always undefined when done is true.
if (done) {
console.log("Stream complete");
para.textContent = value;
return;
}
// value for fetch streams is a Uint8Array
charsReceived += value.length;
const chunk = value;
let listItem = document.createElement("li");
listItem.textContent = `Received ${charsReceived} characters so far. Current chunk = ${chunk}`;
list2.appendChild(listItem);
result += chunk;
// Read some more, and call this function again
return reader.read().then(processText);
});
}
Spezifikationen Browser-Kompatibilität Siehe auch
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4