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

CKTIS / JavaScript

WritableStream — zapisovatelný proud

WritableStream řadí zápisy datových částí do cílového objektu za sebou. Promises umožňují producentům řídit tempo produkce.

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 WritableStream({ start(controller) {}, write(chunk, controller) {}, close() {}, abort(reason) {} }, strategy)

WritableStream je webové API definované standardem Streams Standard, nikoli jazykem ECMAScript. Dostupnost ověřte v cílovém prostředí; Node 24 nepotvrzuje podporu v prohlížečích.

Volitelné callbacky cílového objektu: start(controller) provede inicializaci; write(chunk, controller) zapisuje postupně po inicializaci; close() po zápisech vše ukončí; abort(reason) při přerušení provede úklid. Přerušení zahodí čekající zápisy, místo aby je dokončilo.

getWriter() proud uzamkne. Poté používejte writer.write(), writer.close() a writer.abort(); stream.close() a stream.abort() jsou při uzamčení zamítnuty. releaseLock() zámek uvolní, ale proud neuzavře.

Čekání na write() reguluje tempo produkce; writer.ready signalizuje, že zpětný tlak polevil. Samotné řazení do fronty neomezuje využití paměti. Úspěšný zápis nezaručuje trvalé uložení dat.

Příklady

async function main() {
  const events = [];
  const stream = new WritableStream({
    start() { events.push('start'); },
    write(chunk) { events.push(`write:${chunk}`); },
    close() { events.push('close'); },
    abort(reason) { events.push(`abort:${reason}`); }
  });
  const writer = stream.getWriter();
  try {
    await writer.write('A');
    await writer.write('B');
    await writer.close();
  } finally {
    writer.releaseLock();
  }
  console.log(events.join(' | '));
}
main().catch(console.error);

Výsledek

start | write:A | write:B | close

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