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
signalet une méthodeabort(raison). C'est le mécanisme d'annulation standard de la plate-forme, accepté parfetch, les fonctions denode:fs/promiseset beaucoup de bibliothèques.- AbortSignal
Le jeton passé à l'opération. Il porte
aborted,reason,throwIfAborted()et l'événementabort. 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 à unsetTimeoutnu.- 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
namevalant"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.
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.