WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

WritableStream — beschreibbarer Stream

WritableStream reiht Schreibvorgänge mit Datenblöcken an ein Ziel nacheinander ein. Promises ermöglichen es Produzenten, ihr Tempo zu steuern.

Version: 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 ist eine Web-API, die im Streams Standard und nicht in ECMAScript definiert ist. Prüfe die Verfügbarkeit in der Zielumgebung; Node 24 belegt keine Browser-Unterstützung.

Optionale Callbacks des Ziels: start(controller) initialisiert; write(chunk, controller) schreibt nach der Initialisierung der Reihe nach; close() beendet nach den Schreibvorgängen; abort(reason) räumt bei einem Abbruch auf. Bei einem Abbruch werden ausstehende Schreibvorgänge verworfen, statt abgeschlossen.

getWriter() sperrt den Stream. Verwende dann writer.write(), writer.close() und writer.abort(); stream.close() und stream.abort() lehnen ab, solange der Stream gesperrt ist. releaseLock() hebt die Sperre auf, ohne den Stream zu schließen.

Das Warten auf write() steuert das Produktionstempo; writer.ready signalisiert nachlassenden Gegendruck. Alleiniges Einreihen in die Warteschlange begrenzt den Speicherverbrauch nicht. Ein erfolgreicher Schreibvorgang garantiert keine dauerhafte Speicherung.

Beispiele

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

Ergebnis

start | write:A | write:B | close

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen