CKTIS / JavaScript
ReadableStream.getReader(): czytnik i blokada strumienia
getReader() zwraca czytnik i blokuje strumień. Odczyt jest asynchroniczny; releaseLock() zwalnia blokadę, ale nie anuluje strumienia.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
stream.getReader()
stream.getReader({ mode: "byob" })stream.getReader() synchronicznie zwraca ReadableStreamDefaultReader. Blokada uniemożliwia uzyskanie drugiego czytnika; próba kończy się TypeError.
reader.read() zwraca obietnicę wyniku { value, done }. done: true oznacza koniec; odrzucenie obietnicy sygnalizuje błąd. Zwalniaj blokadę przez reader.releaseLock() w finally. Zwolnienie nie anuluje strumienia.
stream.getReader({ mode: "byob" }) zwraca ReadableStreamBYOBReader: read(view) przyjmuje widok bufora. Tryb BYOB wymaga odczytywalnego strumienia bajtowego niezależnie od sposobu jego utworzenia; dla strumienia, który nie jest bajtowy, wywołanie getReader() w tym trybie zgłasza TypeError. Opcja type: "bytes" to jeden ze sposobów utworzenia takiego strumienia. Treść odpowiedzi Fetch, jeśli nie jest null, może być takim strumieniem bez konieczności samodzielnego tworzenia go przez wywołującego. Samo kolejkowanie Uint8Array nie wystarcza.
To Web API ze standardu WHATWG, nie funkcja określonej edycji ECMAScript. Dostępność domyślnego czytnika i BYOB sprawdzaj osobno w docelowym środowisku.
Przykłady
async function main() {
const stream = new ReadableStream({
start(controller) {
controller.enqueue("A");
controller.enqueue("B");
controller.close();
}
});
const reader = stream.getReader();
let text = "";
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
text += value;
}
} finally {
reader.releaseLock();
}
console.log(text);
console.log(stream.locked);
}
main().catch(console.error);Wynik
AB false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.