CKTIS / JavaScript
ReadableStream.pipeThrough(): трансформиране на поток
pipeThrough() насочва данните от потока към записваемата страна на подадена двойка и веднага връща нейната четима страна. Позволява свързване на трансформации с предаване на обратното налягане; не връща promise за завършване.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() е метод на екземпляр, дефиниран от WHATWG Streams, а не от ECMAScript. Приема TransformStream или двойка { writable, readable }: свързва източника с writable и връща точно readable, а не Promise. При произволна двойка методът сам не свързва двете ѝ страни.
По време на прехвърлянето източникът и целевият writable се заключват; ако някой от тях вече е заключен, синхронно възниква TypeError. Верига с TransformStream предава обратното налягане. Консумирай резултата: без потребител трансформацията може да спре. За разлика от това pipeTo() връща promise за завършването на прехвърлянето.
Опциите се отнасят за връзката източник → writable. По подразбиране затварянето на източника затваря целта, грешка в източника прекъсва целта, а грешка в целта отменя източника. Съответно preventClose, preventAbort и preventCancel изключват тези поведения; стойността по подразбиране за всяка е false. signal позволява прекъсване на операцията при спазване на тези опции. Следи за грешки, докато консумираш резултата; pipeThrough() не предоставя вътрешния си promise за прехвърлянето.
Примерът удвоява два блока и изчаква финалния pipeTo(). Провери наличността на API в целевия браузър; наличието на Node 24 в хранилище не доказва поддръжка в браузър.
Примери
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);Резултат
[4,8]
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.