CKTIS / JavaScript
ReadableStream.pipeThrough(): transformacija toka
pipeThrough() usmjerava podatke toka na zapisivu stranu zadanog para i odmah vraća njegovu čitljivu stranu. Omogućuje povezivanje transformacija uz širenje povratnog pritiska; ne vraća promise o dovršetku.
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
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() instancijska je metoda definirana u WHATWG Streams, a ne u ECMAScriptu. Prihvaća TransformStream ili par { writable, readable }: povezuje izvor s writable i vraća točno readable, a ne Promise. Kod proizvoljnog para metoda sama ne povezuje njegove dvije strane.
Tijekom prijenosa zaključavaju se izvor i odredišni writable; ako je bilo koji od njih već zaključan, sinkrono se pojavljuje TypeError. Lanac koji koristi TransformStream širi povratni pritisak. Konzumiraj rezultat: bez potrošača transformacija može zastati. Nasuprot tome, pipeTo() vraća promise koji označava dovršetak prijenosa.
Opcije se odnose na vezu izvora s writable. Prema zadanim postavkama zatvaranje izvora zatvara odredište, pogreška izvora prekida odredište, a pogreška odredišta otkazuje izvor. preventClose, preventAbort i preventCancel redom isključuju ta ponašanja; zadana vrijednost svih jest false. signal omogućuje prekid operacije, uz uvažavanje tih opcija. Prati pogreške dok konzumiraš rezultat; pipeThrough() ne izlaže svoj interni promise prijenosa.
Primjer udvostručuje dva bloka i čeka završni pipeTo(). Provjeri dostupnost API-ja u ciljnom pregledniku; prisutnost Node 24 u repozitoriju ne dokazuje podršku u pregledniku.
Primjeri
async function main() {
const source = new ReadableStream({
start(controller) {
controller.enqueue(2);
controller.enqueue(4);
controller.close();
}
});
const doubled = source.pipeThrough(new TransformStream({
transform(chunk, controller) {
controller.enqueue(chunk * 2);
}
}));
const values = [];
await doubled.pipeTo(new WritableStream({
write(chunk) {
values.push(chunk);
}
}));
console.log(JSON.stringify(values));
}
main().catch(console.error);Rezultat
[4,8]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.