Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

ReadableStream.pipeThrough(): transformace proudu

pipeThrough() směruje data proudu na zapisovatelnou stranu předané dvojice a okamžitě vrací její čitelnou stranu. Umožňuje řetězit transformace s předáváním zpětného tlaku; nevrací příslib dokončení.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

source.pipeThrough({ writable, readable }, { preventClose, preventAbort, preventCancel, signal })

ReadableStream.pipeThrough() je instanční metoda definovaná specifikací WHATWG Streams, nikoli ECMAScriptem. Přijímá TransformStream nebo dvojici { writable, readable }: propojí zdroj s writable a vrátí přesně readable, nikoli Promise. U libovolné dvojice tato metoda sama její dvě strany nepropojí.

Při přenosu se zdroj i cílový writable po dobu operace uzamknou; pokud je některý z nich již uzamčený, synchronně dojde k chybě TypeError. Řetězec používající TransformStream předává zpětný tlak. Výsledek spotřebovávejte: bez příjemce se transformace může zastavit. Naproti tomu pipeTo() vrací příslib dokončení přenosu.

Možnosti se vztahují na spojení zdroje s writable. Ve výchozím nastavení uzavření zdroje uzavře cíl, chyba zdroje přeruší cíl a chyba cíle zruší zdroj. Možnosti preventClose, preventAbort a preventCancel tyto chování postupně vypínají; výchozí hodnota všech je false. signal umožňuje operaci přerušit s ohledem na tyto možnosti. Při spotřebovávání výsledku sledujte chyby; pipeThrough() nezpřístupňuje svůj interní příslib přenosu.

Příklad zdvojnásobí dva bloky a čeká na závěrečné pipeTo(). Ověřte dostupnost API v cílovém prohlížeči; přítomnost Node 24 v úložišti nedokládá podporu v prohlížeči.

Příklady

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);

Výsledek

[4,8]

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje