Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

TransformStream — transformácia streamu

TransformStream prepája zapisovateľnú a čitateľnú stranu. Funkcia transform spracúva bloky dát, zatiaľ čo flush môže pred uzavretím pridať záverečný výstup.

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

Syntax

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

TransformStream je webové API zo štandardu WHATWG Streams Standard, nie funkcia definovaná štandardom ECMAScript. Sprístupňuje writable a readable; pipeThrough() ich prepojí do pipeline.

transform(chunk, controller) spracúva bloky dát postupne. TransformStreamDefaultController.enqueue, volané ako controller.enqueue(value), odovzdá výstup; samotné vrátenie hodnoty ho neodovzdá. Jeden blok môže vytvoriť nula alebo viac výstupov. Bez transform prechádzajú bloky bez zmeny.

flush(controller) sa spustí po transformácii všetkých blokov pri bežnom uzavretí; nejde o všeobecné riešenie upratovania po chybe. Môže vytvoriť záverečný výstup. Obe callback funkcie môžu vrátiť Promise; výnimky alebo odmietnutia spôsobia chybu na oboch stranách.

Spätný tlak odkladá ďalšie zápisy: čítanie musí prebiehať súčasne. Príklad používa pipeTo(). Overte dostupnosť API v cieľovom prehliadači; Node 24 nedokazuje podporu v prehliadačoch.

Prí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ýsledok

[4,6,"sum=5"]

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje