Formations — 1 037 leçons en français

Accueil › Node.js › Composer avec pipeline

Composer avec pipeline

Les fluxintermediaire

Un assemblage de flux se compose avec pipeline, pas avec .pipe().

Les deux écritures

import { createReadStream, createWriteStream } from "node:fs";
import { createGzip } from "node:zlib";

// ⛔ aucune erreur n'est gérée, et aucun flux n'est nettoyé
createReadStream("export.csv")
  .pipe(createGzip())
  .pipe(createWriteStream("export.csv.gz"));
import { pipeline } from "node:stream/promises";

// ✅ erreurs propagées, tous les flux détruits en cas d'échec
await pipeline(
  createReadStream("export.csv"),
  createGzip(),
  createWriteStream("export.csv.gz"),
);

Ce que .pipe() ne fait pas

.pipe() transporte les données et respecte la contre-pression. Il ne propage pas les erreurs : si la source échoue, la destination reste ouverte, le fichier de sortie reste créé et tronqué, et le descripteur fuit. Pire, un flux qui émet error sans écouteur fait tomber le processus entier par exception non interceptée.

Une chaîne de trois .pipe() correcte demande trois écouteurs error et trois appels à destroy. C'est exactement ce que pipeline écrit à votre place.

Ce que pipeline garantit

Garantie .pipe() pipeline
Contre-pression oui oui
Erreur propagée à l'appelant non oui
Tous les flux détruits à l'échec non oui
On sait quand c'est vraiment fini non oui, la promesse

Les termes à connaître

pipeline

La fonction de node:stream/promises qui enchaîne des flux, propage les erreurs et détruit tous les flux de la chaîne quand l'un échoue.

.pipe()

La méthode historique de branchement. Elle transporte les données, mais ne propage pas les erreurs et ne nettoie pas les flux restants.

Fuite de descripteur

Un fichier ou une socket resté ouvert parce que personne ne l'a détruit. Le processus finit par atteindre la limite du système — EMFILE.

destroy

La méthode qui ferme un flux et libère sa ressource, avec une erreur facultative. C'est ce que pipeline appelle sur chaque étape en cas d'échec.

Événement error

Un flux qui émet error sans écouteur fait tomber le processus par exception non interceptée. Chaque flux d'une chaîne en pipe en a besoin d'un.

compose

La fonction qui assemble plusieurs flux en un seul flux réutilisable, sans encore les faire couler.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.