CKTIS / JavaScript
ReadableStream.pipeTo — przesyłanie do strumienia zapisywalnego
pipeTo() przesyła fragmenty do WritableStream, uwzględnia backpressure i zwraca obietnicę zakończenia operacji.
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
readable.pipeTo(destination, { preventClose: false, preventAbort: false, preventCancel: false, signal })ReadableStream.pipeTo przesyła fragmenty do WritableStream. Zwraca Promise, która po pomyślnym zakończeniu operacji spełnia się wartością undefined. Natomiast pipeThrough() zwraca istniejący strumień odczytywalny z przekazanej pary, nie tworząc nowego.
Operacja respektuje backpressure: tempo odczytu zależy od gotowości odbiorcy. Blokuje oba strumienie i zwalnia blokady przy zakończeniu; wcześniejsza blokada któregokolwiek powoduje odrzucenie obietnicy błędem TypeError.
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ą tę propagację; domyślnie mają wartość false. Nie tłumią odrzucenia obietnicy. signal przyjmuje AbortSignal; przerwanie anuluje źródło i przerywa cel, z uwzględnieniem tych opcji.
Obsługuj odrzucenie przez await z try/catch lub .catch(). To Web API ze standardu WHATWG Streams, nie funkcja konkretnej edycji ECMAScript. Sprawdź dostępność w docelowej przeglądarce; Node 24 nie dowodzi jej obsługi.
Przykłady
(async () => {
const chunks = [];
const readable = new ReadableStream({
start(controller) {
controller.enqueue("A");
controller.enqueue("B");
controller.close();
}
});
const writable = new WritableStream({
write(chunk) {
chunks.push(chunk);
},
close() {
chunks.push("closed");
}
});
await readable.pipeTo(writable);
console.log(chunks.join("|"));
console.log(readable.locked, writable.locked);
})().catch(console.error);Wynik
A|B|closed false false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.