CKTIS / JavaScript
AbortController — annuler des opérations fetch
AbortController transmet une demande d’annulation via `signal`. `fetch` construit un objet `Request` avant de vérifier le signal. Si cette construction échoue, la promesse est rejetée avec l’erreur correspondante (par exemple une `TypeError` si l’URL est invalide), même si le signal est déjà annulé. Si `fetch` détecte l’annulation alors que sa promesse est encore en attente, elle est rejetée avec le motif de l’annulation. Si la promesse est déjà accomplie avec un objet `Response`, l’annulation ne change pas son état, mais peut interrompre la lecture en cours du corps de la réponse.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const controller = new AbortController();
const signal = controller.signal;
controller.abort(reason);
fetch(input, { signal });AbortController est une API Web, et ne fait pas partie d’une édition particulière d’ECMAScript. AbortController.signal désigne la propriété d’instance controller.signal ; AbortController.abort désigne la méthode d’instance controller.abort(reason), et non une méthode statique.
Transmettez signal à fetch. abort(reason) signale l’annulation ; la raison par défaut est une DOMException nommée AbortError. Un signal ne peut pas être réinitialisé : une nouvelle opération qui doit pouvoir être annulée indépendamment nécessite un nouveau contrôleur.
Si fetch parvient à construire un objet Request et constate que le signal est déjà annulé, la promesse est rejetée avec le motif de l’annulation. L’annulation peut également interrompre la lecture du corps de la réponse, mais n’annule pas le travail déjà effectué par le serveur. Gérez le rejet au lieu d’ignorer les erreurs.
L’exemple annule avant fetch, ce qui élimine les problèmes de concurrence liés au timing. Vérifiez la disponibilité dans le navigateur cible ; la présence de Node 24 dans le dépôt ne prouve pas la prise en charge par les navigateurs.
Exemples
(async () => {
const controller = new AbortController();
const reason = new Error("Cancelled");
controller.abort(reason);
try {
await fetch("data:text/plain,hello", {
signal: controller.signal
});
console.log("unexpected success");
} catch (error) {
console.log(controller.signal.aborted);
console.log(error === reason);
}
})();Résultat
true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.