CKTIS / JavaScript
ReadableStream.pipeTo — prosljeđivanje u zapisivi tok
pipeTo() prenosi blokove u WritableStream, poštuje povratni pritisak i vraća obećanje koje označava dovršetak operacije.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
readable.pipeTo(destination, { preventClose: false, preventAbort: false, preventCancel: false, signal })ReadableStream.pipeTo prenosi blokove u WritableStream. Vraća Promise koji se u slučaju uspjeha ispunjava vrijednošću undefined. Za razliku od njega, pipeThrough() vraća postojeći čitljivi tok iz proslijeđenog para, bez stvaranja novog toka.
Prosljeđivanje poštuje povratni pritisak: čitanje ovisi o spremnosti odredišta. Zaključava oba toka i oslobađa zaključavanja po završetku. Ako je neki od tokova već zaključan, promise se odbija pogreškom TypeError.
Prema zadanim postavkama, zatvaranje izvora zatvara odredište, pogreška izvora prekida odredište, a pogreška odredišta poništava izvor. Opcije preventClose, preventAbort i preventCancel redom isključuju to prosljeđivanje; sve su prema zadanim postavkama false. Ne sprječavaju odbijanje promisea. signal prihvaća AbortSignal; prekid poništava izvor i prekida odredište, uzimajući u obzir te opcije.
Odbijanja obradite pomoću await s try/catch ili pomoću .catch(). Ovo je Web API standarda WHATWG Streams, a ne značajka određenog izdanja ECMAScripta. Provjerite dostupnost u ciljnom pregledniku; Node 24 ne potvrđuje podršku u preglednicima.
Primjeri
(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);Rezultat
A|B|closed false false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.