Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

TransformStream — transformace streamu

TransformStream propojuje zapisovatelnou a čitelnou stranu. Funkce transform zpracovává bloky dat, zatímco flush může před uzavřením přidat závěrečný výstup.

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

Syntaxe

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

TransformStream je webové API ze standardu WHATWG Streams Standard, nikoli funkce definovaná standardem ECMAScript. Zpřístupňuje writable a readable; pipeThrough() je propojí do pipeline.

transform(chunk, controller) zpracovává bloky dat postupně. TransformStreamDefaultController.enqueue, volané jako controller.enqueue(value), předává výstup; samotné vrácení hodnoty jej nepředá. Jeden blok může vytvořit nula nebo více výstupů. Bez transform procházejí bloky beze změny.

flush(controller) se spustí po transformaci všech bloků při běžném uzavření; nejde o obecné řešení úklidu po chybě. Může vytvořit závěrečný výstup. Obě callback funkce mohou vrátit Promise; výjimky nebo odmítnutí způsobí chybu na obou stranách.

Zpětný tlak odkládá další zápisy: čtení musí probíhat současně. Příklad používá pipeTo(). Ověřte dostupnost API v cílovém prohlížeči; Node 24 nedokládá podporu v prohlížečích.

Příklady

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

Výsledek

[4,6,"sum=5"]

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje