Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

ReadableStream.pipeThrough(): pretvorba toka

pipeThrough() usmeri podatke toka na zapisljivo stran podanega para in takoj vrne njegovo berljivo stran. Omogoča veriženje pretvorb s širjenjem povratnega tlaka; ne vrne obljube o zaključku.

Različica: 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() je instančna metoda, ki jo določa WHATWG Streams, ne ECMAScript. Sprejme TransformStream ali par { writable, readable }: vir poveže z writable in vrne natanko readable, ne pa Promise. Pri poljubnem paru metoda obeh strani ne poveže sama.

Med pretakanjem sta vir in ciljni writable zaklenjena; če je kateri od njiju že zaklenjen, se sinhrono pojavi napaka TypeError. Veriga, ki uporablja TransformStream, širi povratni tlak. Rezultat porabljaj: brez porabnika se lahko pretvorba ustavi. pipeTo() pa vrne obljubo o zaključku pretakanja.

Možnosti veljajo za povezavo vira z writable. Privzeto zaprtje vira zapre cilj, napaka vira prekine cilj, napaka cilja pa prekliče vir. preventClose, preventAbort in preventCancel zaporedoma izklopijo ta vedenja; privzeta vrednost vseh je false. signal omogoča prekinitev operacije ob upoštevanju teh možnosti. Med porabo rezultata spremljaj napake; pipeThrough() ne razkrije svoje notranje obljube o pretakanju.

Primer podvoji dva kosa in počaka na končni pipeTo(). Preveri, ali so API-ji na voljo v ciljnem brskalniku; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku.

Primeri

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]

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri