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

CKTIS / JavaScript

ReadableStream.pipeThrough(): transformar un flujo

pipeThrough() dirige los datos del flujo al lado writable de un par proporcionado y devuelve inmediatamente su lado readable. Permite encadenar transformaciones propagando la contrapresión; no devuelve una promesa de finalización.

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

source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })

ReadableStream.pipeThrough() es un método de instancia definido por WHATWG Streams, no por ECMAScript. Acepta un TransformStream o un par { writable, readable }: conecta la fuente a writable y devuelve exactamente readable, no una Promise. Si se proporciona un par cualquiera, el método no conecta por sí mismo sus dos lados.

El piping bloquea la fuente y el writable de destino durante la operación; si alguno ya está bloqueado, se produce un TypeError síncrono. Una cadena que usa TransformStream propaga la contrapresión. Consume el resultado: sin un consumidor, la transformación puede quedarse bloqueada. En cambio, pipeTo() devuelve una promesa que indica que el piping ha finalizado.

Las opciones se aplican a la conexión de la fuente con writable. De forma predeterminada, el cierre de la fuente cierra el destino, un error de la fuente aborta el destino y un error del destino cancela la fuente. preventClose, preventAbort y preventCancel, respectivamente, desactivan estos comportamientos; todas tienen el valor predeterminado false. signal permite abortar la operación, sujeto a esas opciones. Observa los errores al consumir el resultado; pipeThrough() no expone su promesa interna de piping.

El ejemplo duplica dos fragmentos y espera al pipeTo() final. Comprueba que las API estén disponibles en el navegador de destino; que un repositorio incluya Node 24 no demuestra que sean compatibles con el navegador.

Ejemplos

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

  const doubled = source.pipeThrough(new TransformStream({
    transform(chunk, controller) {
      controller.enqueue(chunk * 2);
    }
  }));

  const values = [];
  await doubled.pipeTo(new WritableStream({
    write(chunk) {
      values.push(chunk);
    }
  }));
  console.log(JSON.stringify(values));
}

main().catch(console.error);

Resultado

[4,8]

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