CKTIS / JavaScript
ReadableStream.pipeThrough(): przetwarzanie strumienia
pipeThrough() kieruje dane strumienia do strony writable przekazanej pary i natychmiast zwraca jej readable. Umożliwia łączenie transformacji z propagacją przeciwciśnienia; nie zwraca obietnicy zakończenia.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })ReadableStream.pipeThrough() jest metodą instancji zdefiniowaną w WHATWG Streams, nie w ECMAScript. Przyjmuje TransformStream lub parę { writable, readable }: łączy źródło z writable i zwraca dokładnie readable, nie Promise. Dla dowolnej pary sama metoda nie zapewnia połączenia jej stron.
Przesyłanie blokuje źródło i docelowy writable na czas operacji; wcześniejsza blokada któregoś z nich powoduje synchroniczny TypeError. Łańcuch z TransformStream propaguje przeciwciśnienie. Konsumuj wynik: bez odbiorcy transformacja może czekać. pipeTo() zwraca natomiast obietnicę zakończenia przesyłania.
Opcje dotyczą połączenia źródło → writable. Domyślnie zamknięcie źródła zamyka cel, błąd źródła przerywa cel, a błąd celu anuluje źródło. Odpowiednio preventClose, preventAbort i preventCancel wyłączają te zachowania; domyślnie mają wartość false. signal umożliwia przerwanie operacji, z uwzględnieniem tych opcji. Obserwuj błędy podczas konsumpcji wyniku; pipeThrough() nie udostępnia wewnętrznej obietnicy przesyłania.
Przykład podwaja dwa fragmenty i oczekuje na końcowe pipeTo(). Sprawdź dostępność użytych API w docelowej przeglądarce; obecność Node 24 w repozytorium nie potwierdza obsługi przeglądarkowej.
Przykłady
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);Wynik
[4,8]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.