Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

TransformStream — transformar um fluxo

TransformStream liga um lado de escrita a um lado de leitura. transform processa os blocos de dados, enquanto flush pode acrescentar uma saída final antes do fecho.

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

Sintaxe

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

TransformStream é uma API Web do WHATWG Streams Standard, não uma funcionalidade definida pelo ECMAScript. Expõe writable e readable; pipeThrough() liga-os numa cadeia de processamento.

transform(chunk, controller) processa os blocos de dados sequencialmente. TransformStreamDefaultController.enqueue, chamado como controller.enqueue(value), emite uma saída; devolver um valor, por si só, não a emite. Um bloco pode produzir zero ou várias saídas. Sem transform, os blocos passam sem alterações.

flush(controller) é executado depois de todos os blocos serem transformados durante um fecho normal; não é uma operação geral de limpeza em caso de erro. Pode emitir uma saída final. Ambas as funções de retorno podem devolver uma Promise; exceções ou rejeições provocam um erro em ambos os lados.

A contrapressão atrasa as escritas seguintes: a leitura tem de avançar em simultâneo. O exemplo usa pipeTo(). Verifica a disponibilidade da API no navegador de destino; o Node 24 não comprova o suporte nos navegadores.

Exemplos

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

Resultado

[4,6,"sum=5"]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes