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

CKTIS / JavaScript

ReadableStream.pipeTo — presmerovanie do zapisovateľného streamu

pipeTo() prenáša bloky do WritableStream, rešpektuje spätný tlak a vracia promise, ktorá signalizuje dokončenie operácie.

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

readable.pipeTo(destination, { preventClose: false, preventAbort: false, preventCancel: false, signal })

ReadableStream.pipeTo prenáša bloky do WritableStream. Vracia Promise, ktorá sa pri úspechu splní hodnotou undefined. Naproti tomu pipeThrough() vracia existujúci čitateľný stream z odovzdanej dvojice a nový stream nevytvára.

Presmerovanie rešpektuje spätný tlak: čítanie závisí od pripravenosti cieľa. Metóda uzamkne oba streamy a po dokončení zámky uvoľní. Ak je niektorý zo streamov už uzamknutý, promise sa zamietne s chybou TypeError.

Predvolene uzavretie zdroja uzavrie cieľ, chyba zdroja preruší cieľ a chyba cieľa zruší zdroj. Možnosti preventClose, preventAbort a preventCancel vypínajú príslušné spôsoby šírenia; všetky majú predvolenú hodnotu false. Nezabraňujú zamietnutiu promise. signal prijíma AbortSignal; prerušenie zruší zdroj a preruší cieľ s ohľadom na tieto možnosti.

Zamietnutie ošetrite pomocou await s try/catch alebo pomocou .catch(). Ide o Web API zo štandardu WHATWG Streams, nie o funkciu konkrétneho vydania ECMAScriptu. Dostupnosť overte v cieľovom prehliadači; Node 24 nedokazuje podporu v prehliadačoch.

Príklady

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

Výsledok

A|B|closed
false false

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

Zdroje