Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ReadableStream.getReader(): čtečky a uzamčení streamu

getReader() vrací čtečku a uzamkne stream. Čtení je asynchronní; releaseLock() zámek uvolní, ale stream nezruší.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

stream.getReader()
stream.getReader({ mode: "byob" })

stream.getReader() synchronně vrací ReadableStreamDefaultReader. Zámek brání získání další čtečky; pokus o to vyvolá TypeError.

reader.read() vrací promise s výsledkem { value, done }. done: true znamená konec; odmítnutí promise signalizuje chybu. Zámek uvolněte pomocí reader.releaseLock() v bloku finally. Uvolnění stream nezruší.

stream.getReader({ mode: "byob" }) vrací ReadableStreamBYOBReader: read(view) přijímá pohled na buffer. Režim BYOB vyžaduje čitelný bajtový stream bez ohledu na to, jak vznikl. Volání getReader() v tomto režimu na streamu, který není bajtový, vyvolá TypeError. Volba type: "bytes" je jedním ze způsobů, jak takový stream vytvořit. Tělo odpovědi Fetch, pokud není null, může být už samo čitelným bajtovým streamem, aniž by ho volající kód musel vytvářet. Pouhé zařazování bloků Uint8Array do fronty nestačí.

Jde o webové API WHATWG, nikoli o funkci konkrétní edice ECMAScriptu. V cílovém prostředí ověřte dostupnost výchozí čtečky a BYOB zvlášť.

Příklady

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);

Výsledek

AB
false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje