Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła