Accueil › Node.js › Pourquoi un flux
Pourquoi un flux
Les fluxintermediaire
Un flux livre les données par morceaux. C'est tout, et c'est ce qui change ce qu'un serveur peut faire.
Le même travail, deux consommations
import { readFile } from "node:fs/promises";
// ⛔ un fichier de 2 Go → 2 Go de mémoire, d'un seul coup
const contenu = await readFile("export.csv", "utf8");
console.log(contenu.split("\n").length);
import { createReadStream } from "node:fs";
// ✅ 64 Ko à la fois, quelle que soit la taille du fichier
let lignes = 0;
for await (const morceau of createReadStream("export.csv", "utf8")) {
lignes += morceau.split("\n").length - 1;
}
console.log(lignes);
Les deux versions sont asynchrones et ne bloquent pas la boucle d'événements. La différence n'est pas la vitesse : c'est la mémoire. La première est proportionnelle à la taille de la source, la seconde est constante.
Pourquoi la mémoire, et pas le processeur
Un processus Node a un tas borné. Dépasser ce plafond ne ralentit pas le
service : il meurt, avec JavaScript heap out of memory, en emportant
toutes les requêtes en cours. Sur un service qui manipule des fichiers ou de
gros résultats de base, c'est la mémoire qui fixe le nombre de requêtes
simultanées tenables, longtemps avant le processeur.
Les quatre familles
| Famille | Rôle | Exemple |
|---|---|---|
Readable |
source | createReadStream, requête HTTP entrante |
Writable |
destination | createWriteStream, réponse HTTP |
Transform |
les deux | compression, chiffrement, conversion |
Duplex |
les deux, indépendants | une socket TCP |
Un flux lisible est un itérateur asynchrone : for await suffit à le
consommer, sans aucun écouteur d'événement.
Les termes à connaître
- Flux
Un objet qui livre ou accepte des données par morceaux, dans le temps, au lieu d'exiger que tout soit présent en mémoire d'un seul coup.
- Morceau
L'unité livrée par un flux — un
Bufferd'octets par défaut, une chaîne si un encodage est fixé, n'importe quelle valeur en mode objet.- Taille de tampon
Le volume qu'un flux accepte de garder en attente avant de signaler qu'il est plein. Réglée par
highWaterMark, 64 Ko par défaut pour un flux d'octets de fichier.- Mémoire du processus
La ressource qui limite une instance Node bien avant le processeur. Le tas de V8 a un plafond, et le dépasser tue le processus.
- Flux lisible
La source — un fichier ouvert en lecture, une réponse HTTP entrante, la sortie d'une requête SQL en mode curseur.
- Flux inscriptible
La destination — un fichier en écriture, la réponse HTTP sortante, une socket.
- Itérateur asynchrone
La façon moderne de consommer un flux lisible :
for await (const morceau of flux). Tout flux lisible en est un.
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.