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

CKTIS / JavaScript

ReadableStream.pipeTo — canalizar a un flujo de escritura

pipeTo() transfiere fragmentos a un WritableStream, respeta la contrapresión y devuelve una promesa que indica que la operación ha terminado.

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

readable.pipeTo(destination, { preventClose: false, preventAbort: false, preventCancel: false, signal })

ReadableStream.pipeTo transfiere fragmentos a un WritableStream. Devuelve una Promise que se cumple con undefined si la operación tiene éxito. En cambio, pipeThrough() devuelve el flujo de lectura que ya forma parte del par proporcionado, sin crear uno nuevo.

La canalización respeta la contrapresión: la lectura depende de que el destino esté preparado. Bloquea ambos flujos y libera los bloqueos al terminar. Si alguno ya está bloqueado, la promesa se rechaza con un TypeError.

De forma predeterminada, el cierre del origen cierra el destino, un error del origen aborta el destino y un error del destino cancela el origen. preventClose, preventAbort y preventCancel desactivan, respectivamente, esa propagación; las tres opciones tienen el valor predeterminado false. No evitan el rechazo de la promesa. signal acepta un AbortSignal; al abortar, se cancela el origen y se aborta el destino, sujeto a esas opciones.

Gestiona los rechazos con await y try/catch, o con .catch(). Esta es una API web del estándar WHATWG Streams, no una característica de una edición concreta de ECMAScript. Comprueba su disponibilidad en el navegador de destino; Node 24 no demuestra que sea compatible con los navegadores.

Ejemplos

(async () => {
  const chunks = [];
  const readable = new ReadableStream({
    start(controller) {
      controller.enqueue("A");
      controller.enqueue("B");
      controller.close();
    }
  });
  const writable = new WritableStream({
    write(chunk) {
      chunks.push(chunk);
    },
    close() {
      chunks.push("closed");
    }
  });

  await readable.pipeTo(writable);
  console.log(chunks.join("|"));
  console.log(readable.locked, writable.locked);
})().catch(console.error);

Resultado

A|B|closed
false false

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