CKTIS / JavaScript
ReadableStream.pipeThrough(): einen Stream transformieren
pipeThrough() leitet Stream-Daten an die writable-Seite eines übergebenen Paars weiter und gibt sofort dessen readable-Seite zurück. So lassen sich Transformationen mit Backpressure-Weitergabe verketten; eine Promise für den Abschluss wird nicht zurückgegeben.
Version: 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() ist eine Instanzmethode aus WHATWG Streams, nicht aus ECMAScript. Sie akzeptiert einen TransformStream oder ein { writable, readable }-Paar: Sie verbindet die Quelle mit writable und gibt genau readable zurück, keine Promise. Bei einem beliebigen Paar verbindet die Methode selbst die beiden Seiten nicht.
Während des Piping sind die Quelle und das Ziel-writable für den Vorgang gesperrt; eine bereits bestehende Sperre auf einem der beiden führt synchron zu einem TypeError. Eine Kette mit TransformStream gibt Backpressure weiter. Verbrauche das Ergebnis: Ohne Verbraucher kann die Transformation ins Stocken geraten. Im Gegensatz dazu gibt pipeTo() eine Promise zurück, die den Abschluss des Piping signalisiert.
Die Optionen gelten für die Verbindung von Quelle zu writable. Standardmäßig schließt das Schließen der Quelle das Ziel, ein Fehler der Quelle bricht das Ziel ab und ein Fehler des Ziels bricht die Quelle ab. preventClose, preventAbort und preventCancel deaktivieren jeweils dieses Verhalten; standardmäßig sind alle auf false gesetzt. signal ermöglicht das Abbrechen des Vorgangs, vorbehaltlich dieser Optionen. Beobachte Fehler beim Verbrauchen des Ergebnisses; pipeThrough() legt seine interne Piping-Promise nicht offen.
Das Beispiel verdoppelt zwei Chunks und wartet auf das abschließende pipeTo(). Prüfe, ob die APIs in deinem Zielbrowser verfügbar sind; Node 24 in einem Repository belegt keine Browserunterstützung.
Beispiele
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);Ergebnis
[4,8]
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.