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.