Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła