CKTIS / JavaScript
ReadableStream.pipeThrough(): pretvorba toka
pipeThrough() usmeri podatke toka na zapisljivo stran podanega para in takoj vrne njegovo berljivo stran. Omogoča veriženje pretvorb s širjenjem povratnega tlaka; ne vrne obljube o zaključku.
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
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() je instančna metoda, ki jo določa WHATWG Streams, ne ECMAScript. Sprejme TransformStream ali par { writable, readable }: vir poveže z writable in vrne natanko readable, ne pa Promise. Pri poljubnem paru metoda obeh strani ne poveže sama.
Med pretakanjem sta vir in ciljni writable zaklenjena; če je kateri od njiju že zaklenjen, se sinhrono pojavi napaka TypeError. Veriga, ki uporablja TransformStream, širi povratni tlak. Rezultat porabljaj: brez porabnika se lahko pretvorba ustavi. pipeTo() pa vrne obljubo o zaključku pretakanja.
Možnosti veljajo za povezavo vira z writable. Privzeto zaprtje vira zapre cilj, napaka vira prekine cilj, napaka cilja pa prekliče vir. preventClose, preventAbort in preventCancel zaporedoma izklopijo ta vedenja; privzeta vrednost vseh je false. signal omogoča prekinitev operacije ob upoštevanju teh možnosti. Med porabo rezultata spremljaj napake; pipeThrough() ne razkrije svoje notranje obljube o pretakanju.
Primer podvoji dva kosa in počaka na končni pipeTo(). Preveri, ali so API-ji na voljo v ciljnem brskalniku; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku.
Primeri
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]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.