CKTIS / JavaScript
ReadableStream.pipeTo — presmerovanie do zapisovateľného streamu
pipeTo() prenáša bloky do WritableStream, rešpektuje spätný tlak a vracia promise, ktorá signalizuje dokončenie operácie.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
readable.pipeTo(destination, { preventClose: false, preventAbort: false, preventCancel: false, signal })ReadableStream.pipeTo prenáša bloky do WritableStream. Vracia Promise, ktorá sa pri úspechu splní hodnotou undefined. Naproti tomu pipeThrough() vracia existujúci čitateľný stream z odovzdanej dvojice a nový stream nevytvára.
Presmerovanie rešpektuje spätný tlak: čítanie závisí od pripravenosti cieľa. Metóda uzamkne oba streamy a po dokončení zámky uvoľní. Ak je niektorý zo streamov už uzamknutý, promise sa zamietne s chybou TypeError.
Predvolene uzavretie zdroja uzavrie cieľ, chyba zdroja preruší cieľ a chyba cieľa zruší zdroj. Možnosti preventClose, preventAbort a preventCancel vypínajú príslušné spôsoby šírenia; všetky majú predvolenú hodnotu false. Nezabraňujú zamietnutiu promise. signal prijíma AbortSignal; prerušenie zruší zdroj a preruší cieľ s ohľadom na tieto možnosti.
Zamietnutie ošetrite pomocou await s try/catch alebo pomocou .catch(). Ide o Web API zo štandardu WHATWG Streams, nie o funkciu konkrétneho vydania ECMAScriptu. Dostupnosť overte v cieľovom prehliadači; Node 24 nedokazuje podporu v prehliadačoch.
Prí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ýsledok
A|B|closed false false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.