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.