Formations — 1 037 leçons en français

Accueil › Node.js › Pourquoi une file

Pourquoi une file

Tâches de fond et filesavance

Certains travaux n'ont pas leur place dans le temps d'une requête HTTP.

// ⛔ le client attend le service de courriel
app.post("/inscriptions", async (req, res) => {
  const user = await db.creerUtilisateur(req.body);
  await courriel.envoyer(user.email, "bienvenue");   // 8 s, ou une panne
  res.status(201).json(user);
});

Si le service de courriel répond en huit secondes, l'inscription prend huit secondes. S'il est en panne, l'inscription échoue — alors que l'utilisateur est bel et bien créé en base.

// ✅ l'effet est promis, pas attendu
app.post("/inscriptions", async (req, res) => {
  const user = await db.creerUtilisateur(req.body);
  await file.ajouter("courriel-bienvenue", { userId: user.id });
  res.status(201).json(user);
});

Les quatre travaux qui sortent de la requête

Travail Pourquoi dehors
Envoyer un courriel, un SMS dépend d'un tiers indisponible
Produire un document, une facture long, et le client n'en a pas besoin tout de suite
Appeler un service lent sa latence devient la vôtre
Recalculer un agrégat, un index coûteux, et peut être légèrement en retard

Le contrat change

Ce qui sortait de la requête ne peut plus être rendu dans la requête. On ne renvoie donc plus 200 avec un résultat, mais 202 et un moyen de suivre :

res.status(202)
   .location(`/exports/${tache.id}`)
   .json({ id: tache.id, etat: "en-attente" });

Le client interroge ensuite cette adresse, ou reçoit une notification. C'est une décision d'interface, pas un détail technique : elle se négocie avec celui qui écrit le client.

Les termes à connaître

Tâche de fond

Un travail déclenché par une requête mais exécuté après elle. Le client reçoit une réponse immédiate, le travail se fait ailleurs.

File de travaux

Une liste persistante de travaux à faire, écrite par un producteur et lue par un ou plusieurs consommateurs. Elle survit au redémarrage du processus.

Producteur

Le code qui dépose un travail dans la file — en général le gestionnaire de requête HTTP. Il ne sait pas qui l'exécutera, ni quand.

Consommateur

Un processus séparé qui retire les travaux de la file et les exécute. On en lance plusieurs pour aller plus vite.

202 Accepted

Le code de statut qui dit « j'ai pris votre demande, elle n'est pas encore faite ». Accompagné d'un moyen de suivre l'avancement.

Contre-pression

Ce qui arrive quand la file se remplit plus vite qu'elle ne se vide. La longueur de la file est la métrique qui l'annonce.

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.