WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

TransformStream — einen Stream transformieren

TransformStream verbindet eine beschreibbare mit einer lesbaren Seite. transform verarbeitet Datenblöcke, während flush vor dem Schließen eine abschließende Ausgabe anhängen kann.

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 TransformStream({ transform(chunk, controller) { /* controller.enqueue(value) */ }, flush(controller) { /* optional final output */ } }, writableStrategy, readableStrategy)

TransformStream ist eine Web-API aus dem WHATWG Streams Standard und keine von ECMAScript definierte Funktion. Sie stellt writable und readable bereit; pipeThrough() verbindet beide zu einer Pipeline.

transform(chunk, controller) verarbeitet Datenblöcke nacheinander. TransformStreamDefaultController.enqueue, aufgerufen als controller.enqueue(value), gibt eine Ausgabe aus; allein durch das Zurückgeben eines Werts wird nichts ausgegeben. Ein Datenblock kann null, eine oder mehrere Ausgaben erzeugen. Ohne transform werden die Datenblöcke unverändert weitergeleitet.

flush(controller) wird nach der Verarbeitung aller Datenblöcke bei einem regulären Schließen ausgeführt, nicht als allgemeine Fehlerbereinigung. Die Methode kann eine abschließende Ausgabe erzeugen. Beide Callbacks können ein Promise zurückgeben; Ausnahmen oder Zurückweisungen führen zu einem Fehler auf beiden Seiten.

Gegendruck verzögert weitere Schreibvorgänge: Das Lesen muss gleichzeitig fortschreiten. Das Beispiel verwendet pipeTo(). Prüfe die Verfügbarkeit der API im Zielbrowser; Node 24 belegt keine Unterstützung in Browsern.

Beispiele

async function main() {
  const source = new ReadableStream({
    start(controller) {
      controller.enqueue(2);
      controller.enqueue(3);
      controller.close();
    }
  });

  let total = 0;
  const double = new TransformStream({
    transform(chunk, controller) {
      total += chunk;
      controller.enqueue(chunk * 2);
    },
    flush(controller) {
      controller.enqueue(`sum=${total}`);
    }
  });

  const output = [];
  await source.pipeThrough(double).pipeTo(new WritableStream({
    write(chunk) {
      output.push(chunk);
    }
  }));
  console.log(JSON.stringify(output));
}

main().catch(console.error);

Ergebnis

[4,6,"sum=5"]

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