Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

TransformStream — transformiranje toka

TransformStream povezuje zapisivu i čitljivu stranu. Funkcija transform obrađuje blokove podataka, dok flush može dodati završni izlaz prije zatvaranja.

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

new TransformStream({ transform(chunk, controller) { /* controller.enqueue(value) */ }, flush(controller) { /* optional final output */ } }, writableStrategy, readableStrategy)

TransformStream je web-API iz standarda WHATWG Streams Standard, a ne funkcija koju definira ECMAScript. Izlaže writable i readable; pipeThrough() povezuje ih u cjevovod.

transform(chunk, controller) obrađuje blokove podataka redom. TransformStreamDefaultController.enqueue, pozvan kao controller.enqueue(value), emitira izlaz; samo vraćanje vrijednosti ne emitira ga. Jedan blok može proizvesti nula ili više izlaza. Bez funkcije transform blokovi prolaze nepromijenjeni.

flush(controller) pokreće se nakon transformacije svih blokova pri uobičajenom zatvaranju; nije opće čišćenje nakon pogreške. Može emitirati završni izlaz. Obje povratne funkcije mogu vratiti Promise; iznimke ili odbijanja uzrokuju pogrešku na objema stranama.

Povratni pritisak odgađa daljnje upise: čitanje mora napredovati istodobno. Primjer upotrebljava pipeTo(). Provjerite dostupnost API-ja u ciljnom pregledniku; Node 24 ne dokazuje podršku u preglednicima.

Primjeri

async function main() {
  const source = new ReadableStream({
    start(controller) {
      controller.enqueue(2);
      controller.enqueue(3);
      controller.close();
    }
  });

  let total = 0;
  const double = new TransformStream({
    transform(chunk, controller) {
      total += chunk;
      controller.enqueue(chunk * 2);
    },
    flush(controller) {
      controller.enqueue(`sum=${total}`);
    }
  });

  const output = [];
  await source.pipeThrough(double).pipeTo(new WritableStream({
    write(chunk) {
      output.push(chunk);
    }
  }));
  console.log(JSON.stringify(output));
}

main().catch(console.error);

Rezultat

[4,6,"sum=5"]

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

Izvori