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

CKTIS / JavaScript

WritableStream — zapisovateľný prúd

WritableStream zoraďuje zápisy dátových častí do cieľového objektu za sebou. Promises umožňujú producentom riadiť tempo produkcie.

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

WritableStream je webové API definované štandardom Streams Standard, nie jazykom ECMAScript. Dostupnosť overte v cieľovom prostredí; Node 24 nepotvrdzuje podporu v prehliadačoch.

Voliteľné callbacky cieľového objektu: start(controller) vykoná inicializáciu; write(chunk, controller) zapisuje postupne po inicializácii; close() po zápisoch všetko ukončí; abort(reason) pri prerušení vykoná upratanie. Prerušenie zahodí čakajúce zápisy namiesto ich dokončenia.

getWriter() prúd uzamkne. Potom používajte writer.write(), writer.close() a writer.abort(); stream.close() a stream.abort() sa pri uzamknutí zamietnu. releaseLock() uvoľní zámok, ale prúd neuzavrie.

Čakanie na write() reguluje tempo produkcie; writer.ready signalizuje, že spätný tlak poľavil. Samotné zaraďovanie do frontu neobmedzuje využitie pamäte. Úspešný zápis nezaručuje trvalé uloženie údajov.

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

start | write:A | write:B | close

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

Zdroje