Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

ReadableStream.pipeThrough(): transformácia streamu

pipeThrough() smeruje údaje streamu na zapisovateľnú stranu zadanej dvojice a okamžite vracia jej čitateľnú stranu. Umožňuje reťaziť transformácie s prenášaním spätného tlaku; nevracia prísľub dokončenia.

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

Syntax

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

ReadableStream.pipeThrough() je inštančná metóda definovaná WHATWG Streams, nie ECMAScriptom. Prijíma TransformStream alebo dvojicu { writable, readable }: pripojí zdroj k writable a vráti presne readable, nie Promise. Pri ľubovoľnej dvojici táto metóda sama jej strany neprepája.

Počas prenosu sa zdroj a cieľový writable uzamknú; ak je niektorý z nich už uzamknutý, synchronne vznikne chyba TypeError. Reťazec používajúci TransformStream prenáša spätný tlak. Výsledok spotrebúvajte: bez príjemcu sa transformácia môže zastaviť. Na rozdiel od toho pipeTo() vracia prísľub dokončenia prenosu.

Možnosti sa vzťahujú na spojenie zdroja s writable. Predvolene uzavretie zdroja uzavrie cieľ, chyba zdroja preruší cieľ a chyba cieľa zruší zdroj. preventClose, preventAbort a preventCancel postupne vypínajú tieto správania; predvolená hodnota každej je false. signal umožňuje prerušiť operáciu s prihliadnutím na tieto možnosti. Pri spotrebúvaní výsledku sledujte chyby; pipeThrough() nesprístupňuje svoj interný prísľub prenosu.

Príklad zdvojnásobí dva bloky a čaká na záverečné pipeTo(). Overte dostupnosť API v cieľovom prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači.

Prí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ýsledok

[4,8]

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje