Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ReadableStream.pipeTo — předávání do zapisovatelného streamu

pipeTo() předává bloky do WritableStream, respektuje zpětný tlak a vrací příslib, který signalizuje dokončení operace.

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

Syntaxe

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

ReadableStream.pipeTo předává bloky do WritableStream. Vrací Promise, která se při úspěchu splní hodnotou undefined. Naproti tomu pipeThrough() vrací existující čitelný stream z předané dvojice a žádný nový stream nevytváří.

Předávání respektuje zpětný tlak: čtení závisí na připravenosti cíle. Metoda uzamkne oba streamy a po dokončení zámky uvolní. Pokud je některý ze streamů již uzamčen, příslib se odmítne s chybou TypeError.

Ve výchozím nastavení uzavření zdroje uzavře cíl, chyba zdroje přeruší cíl a chyba cíle zruší zdroj. Možnosti preventClose, preventAbort a preventCancel vypínají odpovídající způsoby šíření; všechny mají výchozí hodnotu false. Nezabraňují odmítnutí příslibu. signal přijímá AbortSignal; přerušení zruší zdroj a přeruší cíl s ohledem na tyto možnosti.

Odmítnutí ošetřete pomocí await s try/catch nebo pomocí .catch(). Jde o Web API ze standardu WHATWG Streams, nikoli o funkci konkrétní edice ECMAScriptu. Dostupnost ověřte v cílovém prohlížeči; Node 24 nedokládá podporu v prohlížečích.

Příklady

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

Výsledek

A|B|closed
false false

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje