Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources