База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

TransformStream — преобразуване на поток

TransformStream свързва записваема и четима страна. transform обработва порциите данни, а flush може да добави краен изход преди затварянето.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

TransformStream е Web API от стандарта WHATWG Streams Standard, а не функция, дефинирана от ECMAScript. Той предоставя writable и readable; pipeThrough() ги свързва в конвейер.

transform(chunk, controller) обработва порциите данни последователно. TransformStreamDefaultController.enqueue, извикан като controller.enqueue(value), извежда резултат; само връщането на стойност не го извежда. Една порция може да произведе нула или повече резултати. Без transform порциите преминават без промяна.

flush(controller) се изпълнява след трансформирането на всички порции при нормално затваряне; това не е универсално почистване при грешка. Може да изведе краен резултат. И двете функции за обратно извикване могат да връщат Promise; изключения или отхвърляния предизвикват грешка и в двете страни.

Обратното налягане забавя следващите записи: четенето трябва да напредва едновременно. Примерът използва pipeTo(). Проверете дали API е наличен в целевия браузър; Node 24 не доказва поддръжка в браузърите.

Примери

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

Резултат

[4,6,"sum=5"]

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници