CKTIS / JavaScript
ReadableStream.pipeThrough(): transformace proudu
pipeThrough() směruje data proudu na zapisovatelnou stranu předané dvojice a okamžitě vrací její čitelnou stranu. Umožňuje řetězit transformace s předáváním zpětného tlaku; nevrací příslib dokončení.
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
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() je instanční metoda definovaná specifikací WHATWG Streams, nikoli ECMAScriptem. Přijímá TransformStream nebo dvojici { writable, readable }: propojí zdroj s writable a vrátí přesně readable, nikoli Promise. U libovolné dvojice tato metoda sama její dvě strany nepropojí.
Při přenosu se zdroj i cílový writable po dobu operace uzamknou; pokud je některý z nich již uzamčený, synchronně dojde k chybě TypeError. Řetězec používající TransformStream předává zpětný tlak. Výsledek spotřebovávejte: bez příjemce se transformace může zastavit. Naproti tomu pipeTo() vrací příslib dokončení přenosu.
Možnosti se vztahují na spojení zdroje s writable. 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 tyto chování postupně vypínají; výchozí hodnota všech je false. signal umožňuje operaci přerušit s ohledem na tyto možnosti. Při spotřebovávání výsledku sledujte chyby; pipeThrough() nezpřístupňuje svůj interní příslib přenosu.
Příklad zdvojnásobí dva bloky a čeká na závěrečné pipeTo(). Ověřte dostupnost API v cílovém prohlížeči; přítomnost Node 24 v úložišti nedokládá podporu v prohlížeči.
Příklady
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);Výsledek
[4,8]
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.