Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

ReadableStream.pipeThrough(): transformacija toka

pipeThrough() usmjerava podatke toka na zapisivu stranu zadanog para i odmah vraća njegovu čitljivu stranu. Omogućuje povezivanje transformacija uz širenje povratnog pritiska; ne vraća promise o dovršetku.

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

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

ReadableStream.pipeThrough() instancijska je metoda definirana u WHATWG Streams, a ne u ECMAScriptu. Prihvaća TransformStream ili par { writable, readable }: povezuje izvor s writable i vraća točno readable, a ne Promise. Kod proizvoljnog para metoda sama ne povezuje njegove dvije strane.

Tijekom prijenosa zaključavaju se izvor i odredišni writable; ako je bilo koji od njih već zaključan, sinkrono se pojavljuje TypeError. Lanac koji koristi TransformStream širi povratni pritisak. Konzumiraj rezultat: bez potrošača transformacija može zastati. Nasuprot tome, pipeTo() vraća promise koji označava dovršetak prijenosa.

Opcije se odnose na vezu izvora s writable. Prema zadanim postavkama zatvaranje izvora zatvara odredište, pogreška izvora prekida odredište, a pogreška odredišta otkazuje izvor. preventClose, preventAbort i preventCancel redom isključuju ta ponašanja; zadana vrijednost svih jest false. signal omogućuje prekid operacije, uz uvažavanje tih opcija. Prati pogreške dok konzumiraš rezultat; pipeThrough() ne izlaže svoj interni promise prijenosa.

Primjer udvostručuje dva bloka i čeka završni pipeTo(). Provjeri dostupnost API-ja u ciljnom pregledniku; prisutnost Node 24 u repozitoriju ne dokazuje podršku u pregledniku.

Primjeri

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

Rezultat

[4,8]

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

Izvori