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/promisesqui 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
pipelineappelle sur chaque étape en cas d'échec.- Événement error
Un flux qui émet
errorsans écouteur fait tomber le processus par exception non interceptée. Chaque flux d'une chaîne enpipeen a besoin d'un.- compose
La fonction qui assemble plusieurs flux en un seul flux réutilisable, sans encore les faire couler.
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.