Formations — 1 037 leçons en français

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 Buffer d'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.

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.