KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

TransformStream — een stream transformeren

TransformStream verbindt een schrijfbare kant met een leesbare kant. transform verwerkt chunks, terwijl flush vóór het sluiten een laatste uitvoer kan toevoegen.

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

TransformStream is een Web-API uit de WHATWG Streams Standard, geen functie die door ECMAScript is gedefinieerd. De API biedt writable en readable; pipeThrough() verbindt ze in een pipeline.

transform(chunk, controller) verwerkt chunks achtereenvolgens. TransformStreamDefaultController.enqueue, aangeroepen als controller.enqueue(value), geeft uitvoer door; alleen een waarde retourneren doet dat niet. Eén chunk kan nul of meerdere uitvoerwaarden opleveren. Zonder transform gaan chunks ongewijzigd door.

flush(controller) wordt uitgevoerd nadat alle chunks zijn getransformeerd bij een normale sluiting; het is geen algemene foutopruiming. De methode kan een laatste uitvoer produceren. Beide callbacks mogen een Promise retourneren; uitzonderingen of afwijzingen veroorzaken een fout aan beide kanten.

Backpressure stelt verdere schrijfbewerkingen uit: het lezen moet tegelijk doorgaan. Het voorbeeld gebruikt pipeTo(). Controleer of de API beschikbaar is in de doelbrowser; Node 24 toont niet aan dat browsers de API ondersteunen.

Voorbeelden

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

Resultaat

[4,6,"sum=5"]

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