Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła