Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ReadableStream.pipeTo — inviare a uno stream scrivibile

pipeTo() trasferisce blocchi a un WritableStream, rispetta la contropressione e restituisce una promise che segnala il completamento dell’operazione.

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

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

ReadableStream.pipeTo trasferisce blocchi a un WritableStream. Restituisce una Promise che, in caso di successo, viene risolta con undefined. pipeThrough(), invece, restituisce lo stream leggibile già presente nella coppia fornita, senza crearne uno nuovo.

L’invio rispetta la contropressione: la lettura dipende dalla disponibilità della destinazione. Blocca entrambi gli stream e rilascia i blocchi al termine. Se uno dei due stream è già bloccato, la promise viene rifiutata con un TypeError.

Per impostazione predefinita, la chiusura della sorgente chiude la destinazione, un errore della sorgente interrompe la destinazione e un errore della destinazione annulla la sorgente. preventClose, preventAbort e preventCancel disattivano rispettivamente questa propagazione; il valore predefinito di tutte è false. Non impediscono il rifiuto della promise. signal accetta un AbortSignal; l’interruzione annulla la sorgente e interrompe la destinazione, fatte salve queste opzioni.

Gestisci i rifiuti usando await con try/catch oppure .catch(). È una Web API dello standard WHATWG Streams, non una funzionalità di una specifica edizione di ECMAScript. Verifica la disponibilità nel browser di destinazione; Node 24 non dimostra il supporto nei browser.

Esempi

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

Risultato

A|B|closed
false false

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