CKTIS / JavaScript
ReadableStream.pipeTo — posredovanje v zapisljivi tok
pipeTo() prenese bloke v WritableStream, upošteva povratni pritisk in vrne obljubo, ki označuje dokončanje operacije.
Različica: 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 prenese bloke v WritableStream. Vrne Promise, ki se ob uspehu izpolni z vrednostjo undefined. pipeThrough() pa vrne obstoječi berljivi tok iz podanega para, ne da bi ustvaril novega.
Posredovanje upošteva povratni pritisk: branje je odvisno od pripravljenosti cilja. Zaklene oba toka in po koncu sprosti zaklepa. Če je kateri od tokov že zaklenjen, se obljuba zavrne z napako TypeError.
Privzeto zaprtje vira zapre cilj, napaka vira prekine cilj, napaka cilja pa prekliče vir. Možnosti preventClose, preventAbort in preventCancel po vrsti onemogočijo to širjenje; vse imajo privzeto vrednost false. Ne preprečijo zavrnitve obljube. signal sprejme AbortSignal; prekinitev prekliče vir in prekine cilj, ob upoštevanju teh možnosti.
Zavrnitve obravnavajte z await in try/catch ali z .catch(). To je spletni API standarda WHATWG Streams, ne funkcija določene izdaje ECMAScript. Razpoložljivost preverite v ciljnem brskalniku; Node 24 ne dokazuje podpore v brskalnikih.
Primeri
(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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.