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.