CKTIS / JavaScript
ReadableStream — odczyt strumienia fragmentami
ReadableStream to API strumieniowego odczytu fragmentów danych. Czytnik pobiera je asynchronicznie, bez konieczności wcześniejszego zebrania całości.
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
new ReadableStream(underlyingSource?, strategy?)ReadableStream należy do standardu Streams, nie do ECMAScript. Domyślny strumień przenosi dowolne wartości JavaScript; tryb type: "bytes" umożliwia odczyt BYOB do bufora odbiorcy.
Źródło używa enqueue() do dodawania fragmentów. close() pozwala odczytać kolejkę do końca; błąd odrzuca odczyty. read() zwraca obietnicę wyniku { value, done }.
getReader() blokuje strumień dla jednego czytnika. releaseLock() zwalnia blokadę, ale nie anuluje źródła. Przy aktywnym czytniku anuluj przez reader.cancel(); anulowanie odrzuca kolejkę.
pull() służy produkowaniu na żądanie; bezwarunkowe enqueue() może powiększać kolejkę mimo presji zwrotnej. Sprawdzaj obsługę docelowego środowiska; Node 24 nie dowodzi obsługi w przeglądarce.
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);
}
main().catch(console.error);Wynik
AB
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.