Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

TransformStream — transformar un flujo

TransformStream conecta un extremo de escritura con uno de lectura. transform procesa los fragmentos, mientras que flush puede añadir una salida final antes del cierre.

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

Sintaxis

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

TransformStream es una API web del WHATWG Streams Standard, no una función definida por ECMAScript. Expone writable y readable; pipeThrough() los conecta en una canalización.

transform(chunk, controller) procesa los fragmentos en orden. TransformStreamDefaultController.enqueue, llamado como controller.enqueue(value), emite una salida; devolver un valor por sí solo no la emite. Un fragmento puede producir cero o varias salidas. Sin transform, los fragmentos pasan sin cambios.

flush(controller) se ejecuta después de transformar todos los fragmentos durante un cierre normal; no es una limpieza general para errores. Puede emitir una salida final. Ambas funciones de retorno pueden devolver una Promise; las excepciones o los rechazos provocan un error en ambos extremos.

La contrapresión retrasa las escrituras siguientes: la lectura debe avanzar al mismo tiempo. El ejemplo usa pipeTo(). Comprueba la disponibilidad de la API en el navegador de destino; Node 24 no demuestra que sea compatible con los navegadores.

Ejemplos

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

Resultado

[4,6,"sum=5"]

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes