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.