Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ReadableStream — čítanie údajov po častiach

ReadableStream umožňuje spracúvať údaje po častiach. Čítačka ich získava asynchrónne bez toho, aby bolo potrebné najprv zhromaždiť celý vstup.

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

Syntax

new ReadableStream(underlyingSource?, strategy?)

ReadableStream patrí do Streams Standard, nie do ECMAScriptu. Predvolené streamy prenášajú ľubovoľné hodnoty JavaScriptu; type: "bytes" umožňuje čítanie BYOB do bufferov dodaných príjemcom.

Zdroje používajú enqueue() na pridávanie častí. close() umožní vyprázdnenie frontu; chyby spôsobia zamietnutie čítaní. read() vráti promise s výsledkom { value, done }.

getReader() uzamkne stream pre jednu čítačku. releaseLock() zámok uvoľní bez zrušenia zdroja. Ak je čítačka aktívna, zrušenie vykonajte pomocou reader.cancel(); zrušenie zahodí front.

pull() podporuje produkciu podľa požiadaviek; bezpodmienečné volanie enqueue() môže zväčšovať front aj napriek spätnému tlaku. Overte podporu v cieľovom prostredí; Node 24 nedokladá podporu v prehliadačoch.

Prí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ýsledok

AB

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje