CKTIS / JavaScript
ReadableStream.pipeThrough(): een stream transformeren
pipeThrough() stuurt streamgegevens naar de writable-kant van een opgegeven paar en retourneert direct de readable-kant. Hiermee kun je transformaties aaneenschakelen met doorgifte van backpressure; er wordt geen promise voor voltooiing geretourneerd.
Versie: 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() is een instantiemethode die is gedefinieerd door WHATWG Streams, niet door ECMAScript. De methode accepteert een TransformStream of een { writable, readable }-paar: hij verbindt de bron met writable en retourneert precies readable, geen Promise. Bij een willekeurig paar verbindt de methode de twee kanten niet zelf.
Tijdens het pipen worden de bron en de doel-writable vergrendeld; als een van beide al vergrendeld is, ontstaat er synchroon een TypeError. Een keten met TransformStream geeft backpressure door. Verwerk het resultaat: zonder afnemer kan de transformatie vastlopen. pipeTo() retourneert daarentegen een promise die aangeeft wanneer het pipen is voltooid.
De opties gelden voor de verbinding van de bron naar writable. Standaard sluit het sluiten van de bron de bestemming, breekt een fout in de bron de bestemming af en annuleert een fout in de bestemming de bron. preventClose, preventAbort en preventCancel schakelen deze gedragingen respectievelijk uit; standaard zijn ze allemaal false. Met signal kun je de bewerking afbreken, met inachtneming van die opties. Houd fouten in de gaten terwijl je het resultaat verwerkt; pipeThrough() stelt de interne piping-promise niet beschikbaar.
Het voorbeeld verdubbelt twee chunks en wacht op de laatste pipeTo(). Controleer of de API's beschikbaar zijn in je doelbrowser; de aanwezigheid van Node 24 in een repository bewijst geen browserondersteuning.
Voorbeelden
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);Resultaat
[4,8]
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.