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

CKTIS / JavaScript

TransformStream — pretvorba toka

TransformStream poveže zapisljivo in berljivo stran. Funkcija transform obdeluje podatkovne kose, flush pa lahko pred zaprtjem doda končni izhod.

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

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

TransformStream je spletni API iz standarda WHATWG Streams Standard in ne funkcija, ki jo določa ECMAScript. Omogoča dostop do writable in readable; pipeThrough() ju poveže v cevovod.

transform(chunk, controller) zaporedno obdeluje podatkovne kose. TransformStreamDefaultController.enqueue, ki ga pokličemo kot controller.enqueue(value), odda izhod; samo vračilo vrednosti ga ne odda. En podatkovni kos lahko ustvari nič ali več izhodov. Brez transform gredo kosi skozi nespremenjeni.

flush(controller) se izvede po obdelavi vseh kosov ob običajnem zaprtju; ne gre za splošno čiščenje po napaki. Lahko odda končni izhod. Obe povratni funkciji lahko vrneta Promise; izjeme ali zavrnitve povzročijo napako na obeh straneh.

Povratni pritisk odloži nadaljnje zapisovanje: branje mora potekati sočasno. Primer uporablja pipeTo(). Preverite, ali je API na voljo v ciljnem brskalniku; Node 24 ne dokazuje podpore v brskalnikih.

Primeri

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"]

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

Viri