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

CKTIS / JavaScript

ReadableStream — čtení dat po částech

ReadableStream umožňuje zpracovávat data po částech. Čtečka je získává asynchronně, aniž by bylo nutné nejprve shromáždit celý vstup.

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

new ReadableStream(underlyingSource?, strategy?)

ReadableStream patří do Streams Standard, nikoli do ECMAScriptu. Výchozí streamy přenášejí libovolné hodnoty JavaScriptu; type: "bytes" umožňuje čtení BYOB do bufferů dodaných příjemcem.

Zdroje používají enqueue() k přidávání částí. close() umožní vyprázdnění fronty; chyby způsobí zamítnutí čtení. read() vrací promise s výsledkem { value, done }.

getReader() uzamkne stream pro jednu čtečku. releaseLock() zámek uvolní, aniž by zrušilo zdroj. Pokud je čtečka aktivní, zrušení proveďte pomocí reader.cancel(); zrušení zahodí frontu.

pull() podporuje produkci podle požadavků; bezpodmínečné volání enqueue() může zvětšovat frontu i přes zpětný tlak. Ověřte podporu v cílovém prostředí; Node 24 nedokládá podporu v prohlížečích.

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

main().catch(console.error);

Výsledek

AB

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