Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

TransformStream — trasformare uno stream

TransformStream collega un lato scrivibile a uno leggibile. transform elabora i blocchi di dati, mentre flush può aggiungere un output finale prima della chiusura.

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

Sintassi

new TransformStream({ transform(chunk, controller) { /* controller.enqueue(value) */ }, flush(controller) { /* optional final output */ } }, writableStrategy, readableStrategy)

TransformStream è una Web API del WHATWG Streams Standard, non una funzionalità definita da ECMAScript. Espone writable e readable; pipeThrough() li collega in una pipeline.

transform(chunk, controller) elabora i blocchi in sequenza. TransformStreamDefaultController.enqueue, chiamato come controller.enqueue(value), emette un output; restituire un valore, da solo, non lo emette. Un blocco può produrre zero o più output. Senza transform, i blocchi passano senza modifiche.

flush(controller) viene eseguito dopo la trasformazione di tutti i blocchi durante una chiusura regolare; non è una procedura generale di pulizia in caso di errore. Può emettere un output finale. Entrambe le funzioni di callback possono restituire una Promise; eccezioni o rifiuti causano un errore su entrambi i lati.

La contropressione ritarda le scritture successive: la lettura deve procedere contemporaneamente. L’esempio usa pipeTo(). Verifica la disponibilità dell’API nel browser di destinazione; Node 24 non dimostra il supporto nei browser.

Esempi

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

Risultato

[4,6,"sum=5"]

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti