Formations — 1 037 leçons en français

Accueil › Node.js › Annuler et expirer

Annuler et expirer

L'asynchrone côté serveurintermediaire

Une opération sans borne de temps n'est pas une opération lente : c'est une fuite. Elle retient une connexion, un jeton de pool, et une place dans la file du serveur.

Expirer

const reponse = await fetch(url, { signal: AbortSignal.timeout(2000) });

AbortSignal.timeout rend un signal qui s'avorte seul après le délai. L'appel rejette avec une erreur dont name vaut "TimeoutError", et la connexion est réellement fermée — contrairement à un Promise.race contre un setTimeout, qui laisse la requête continuer dans le vide.

Annuler

const ctrl = new AbortController();

setTimeout(() => ctrl.abort(new Error("l'utilisateur a changé d'avis")), 500);

try {
  await fetch(url, { signal: ctrl.signal });
} catch (e) {
  if (e.name === "AbortError") return;   // abandon volontaire, pas une panne
  throw e;
}

Un même signal se passe à plusieurs opérations : une seule abort() les arrête toutes. Et un signal déjà avorté fait échouer l'opération immédiatement, sans ouvrir de connexion.

Quand le client raccroche

app.get("/rapport", async (req, res) => {
  const ctrl = new AbortController();
  req.on("close", () => ctrl.abort());

  const signal = AbortSignal.any([ctrl.signal, AbortSignal.timeout(5000)]);
  const données = await agreger(signal);
  res.json(données);
});

Sans ces trois lignes, un client qui abandonne au bout d'une seconde laisse derrière lui une agrégation complète. S'il réessaie trois fois, vous faites quatre fois le travail pour une seule réponse utile — et c'est exactement ce qui transforme un ralentissement en panne.

Les termes à connaître

AbortController

Un objet qui détient un signal et une méthode abort(raison). C'est le mécanisme d'annulation standard de la plate-forme, accepté par fetch, les fonctions de node:fs/promises et beaucoup de bibliothèques.

AbortSignal

Le jeton passé à l'opération. Il porte aborted, reason, throwIfAborted() et l'événement abort. Un signal déjà avorté fait échouer l'opération immédiatement.

AbortSignal.timeout(ms)

Rend un signal qui s'avorte seul après le délai, avec une TimeoutError. Le minuteur n'empêche pas le processus de sortir, contrairement à un setTimeout nu.

AbortSignal.any

Combine plusieurs signaux : le résultat s'avorte dès que l'un d'eux s'avorte. C'est ainsi qu'on cumule le délai d'expiration et la déconnexion du client.

AbortError

L'erreur levée par une opération avortée, de name valant "AbortError". Elle ne signale pas une panne : la journaliser comme une erreur serveur fausse les alertes.

Délai d'expiration

Une borne supérieure au temps d'attente. Sans elle, un appel sortant peut retenir une connexion entrante pendant des minutes, et la file d'attente du serveur grandit sans limite.

Travail orphelin

Un calcul ou un appel dont plus personne n'attend le résultat, parce que l'appelant a abandonné. Il consomme toujours du processeur, une connexion et de la mémoire.

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.