CKTIS / JavaScript
ReadableStream.pipeThrough(): transformácia streamu
pipeThrough() smeruje údaje streamu na zapisovateľnú stranu zadanej dvojice a okamžite vracia jej čitateľnú stranu. Umožňuje reťaziť transformácie s prenášaním spätného tlaku; nevracia prísľub dokončenia.
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
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() je inštančná metóda definovaná WHATWG Streams, nie ECMAScriptom. Prijíma TransformStream alebo dvojicu { writable, readable }: pripojí zdroj k writable a vráti presne readable, nie Promise. Pri ľubovoľnej dvojici táto metóda sama jej strany neprepája.
Počas prenosu sa zdroj a cieľový writable uzamknú; ak je niektorý z nich už uzamknutý, synchronne vznikne chyba TypeError. Reťazec používajúci TransformStream prenáša spätný tlak. Výsledok spotrebúvajte: bez príjemcu sa transformácia môže zastaviť. Na rozdiel od toho pipeTo() vracia prísľub dokončenia prenosu.
Možnosti sa vzťahujú na spojenie zdroja s writable. Predvolene uzavretie zdroja uzavrie cieľ, chyba zdroja preruší cieľ a chyba cieľa zruší zdroj. preventClose, preventAbort a preventCancel postupne vypínajú tieto správania; predvolená hodnota každej je false. signal umožňuje prerušiť operáciu s prihliadnutím na tieto možnosti. Pri spotrebúvaní výsledku sledujte chyby; pipeThrough() nesprístupňuje svoj interný prísľub prenosu.
Príklad zdvojnásobí dva bloky a čaká na záverečné pipeTo(). Overte dostupnosť API v cieľovom prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači.
Prí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ýsledok
[4,8]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.