Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła