KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

WritableStream — beschrijfbare stream

WritableStream voert het schrijven van gegevensblokken naar een bestemming na elkaar uit. Promises stellen producenten in staat hun tempo te regelen.

Versie: 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 is een Web-API die is gedefinieerd door de Streams Standard, niet door ECMAScript. Controleer de beschikbaarheid in de doelomgeving; Node 24 bewijst niet dat browsers dit ondersteunen.

Optionele callbacks van de bestemming: start(controller) initialiseert; write(chunk, controller) schrijft na de initialisatie achtereenvolgens; close() beëindigt na de schrijfbewerkingen; abort(reason) ruimt op bij afbreken. Bij afbreken worden wachtende schrijfbewerkingen weggegooid in plaats van voltooid.

getWriter() vergrendelt de stream. Gebruik dan writer.write(), writer.close() en writer.abort(); stream.close() en stream.abort() worden afgewezen zolang de stream vergrendeld is. releaseLock() ontgrendelt de stream zonder deze te sluiten.

Wachten op write() regelt het productietempo; writer.ready geeft aan dat de tegendruk afneemt. Alleen in de wachtrij plaatsen begrenst het geheugengebruik niet. Een geslaagde schrijfhandeling garandeert geen duurzame opslag.

Voorbeelden

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

Resultaat

start | write:A | write:B | close

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen