Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ReadableStream.pipeTo — prosljeđivanje u zapisivi tok

pipeTo() prenosi blokove u WritableStream, poštuje povratni pritisak i vraća obećanje koje označava dovršetak operacije.

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

Sintaksa

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

ReadableStream.pipeTo prenosi blokove u WritableStream. Vraća Promise koji se u slučaju uspjeha ispunjava vrijednošću undefined. Za razliku od njega, pipeThrough() vraća postojeći čitljivi tok iz proslijeđenog para, bez stvaranja novog toka.

Prosljeđivanje poštuje povratni pritisak: čitanje ovisi o spremnosti odredišta. Zaključava oba toka i oslobađa zaključavanja po završetku. Ako je neki od tokova već zaključan, promise se odbija pogreškom TypeError.

Prema zadanim postavkama, zatvaranje izvora zatvara odredište, pogreška izvora prekida odredište, a pogreška odredišta poništava izvor. Opcije preventClose, preventAbort i preventCancel redom isključuju to prosljeđivanje; sve su prema zadanim postavkama false. Ne sprječavaju odbijanje promisea. signal prihvaća AbortSignal; prekid poništava izvor i prekida odredište, uzimajući u obzir te opcije.

Odbijanja obradite pomoću await s try/catch ili pomoću .catch(). Ovo je Web API standarda WHATWG Streams, a ne značajka određenog izdanja ECMAScripta. Provjerite dostupnost u ciljnom pregledniku; Node 24 ne potvrđuje podršku u preglednicima.

Primjeri

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

Rezultat

A|B|closed
false false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori