CKTIS / JavaScript
TransformStream — transformer un flux
TransformStream relie un côté inscriptible à un côté lisible. transform traite les blocs de données, tandis que flush peut ajouter une sortie finale avant la fermeture.
Version : 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 est une API Web du WHATWG Streams Standard, et non une fonctionnalité définie par ECMAScript. Elle expose writable et readable ; pipeThrough() les relie dans un pipeline.
transform(chunk, controller) traite les blocs de données dans l’ordre. TransformStreamDefaultController.enqueue, appelé sous la forme controller.enqueue(value), émet une sortie ; retourner une valeur ne suffit pas à l’émettre. Un bloc peut produire zéro, une ou plusieurs sorties. Sans transform, les blocs passent sans modification.
flush(controller) s’exécute après le traitement de tous les blocs lors d’une fermeture normale ; ce n’est pas un mécanisme général de nettoyage en cas d’erreur. Il peut émettre une sortie finale. Les deux fonctions de rappel peuvent renvoyer une Promise ; les exceptions ou les rejets font échouer les deux côtés.
La contre-pression retarde les écritures suivantes : la lecture doit progresser en parallèle. L’exemple utilise pipeTo(). Vérifiez la disponibilité de l’API dans le navigateur cible ; Node 24 ne prouve pas sa prise en charge par les navigateurs.
Exemples
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);Résultat
[4,6,"sum=5"]
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.