Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

WritableStream — zapisljiv tok

WritableStream zaporedno razvršča zapisovanje podatkovnih kosov v ponor. Promises producentom omogočajo nadzor nad hitrostjo produkcije.

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

Sintaksa

new WritableStream({ start(controller) {}, write(chunk, controller) {}, close() {}, abort(reason) {} }, strategy)

WritableStream je spletni API, določen s standardom Streams Standard, ne pa z ECMAScriptom. Razpoložljivost preverite v ciljnem okolju; Node 24 ne dokazuje podpore v brskalnikih.

Izbirni povratni klici ponora: start(controller) izvede inicializacijo; write(chunk, controller) po inicializaciji zapisuje zaporedno; close() po zapisih zaključi; abort(reason) ob prekinitvi izvede čiščenje. Prekinitev zavrže čakajoče zapise, namesto da bi jih dokončala.

getWriter() zaklene tok. Nato uporabite writer.write(), writer.close() in writer.abort(); stream.close() in stream.abort() sta zavrnjena, dokler je tok zaklenjen. releaseLock() sprosti zaklep, ne da bi tok zaprl.

Čakanje na write() uravnava hitrost produkcije; writer.ready sporoča, da je povratni pritisk popustil. Samo čakanje v vrsti ne omeji porabe pomnilnika. Uspešen zapis ne zagotavlja trajne hrambe podatkov.

Primeri

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

Rezultat

start | write:A | write:B | close

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri