CKTIS / JavaScript
AbortSignal — signal d’annulation
AbortSignal transmet une demande d’annulation à fetch ; AbortController déclenche l’annulation, tandis que le signal en expose l’état.
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;
fetch(url, { signal });
controller.abort(reason);AbortSignal transmet une demande d’annulation à une opération qui la prend en charge. Récupérez-le via controller.signal depuis un AbortController, puis transmettez-le à fetch sous la forme { signal }. C’est le contrôleur, et non le signal, qui déclenche l’annulation.
Après l’annulation, signal.aborted vaut true. Si la promesse renvoyée par fetch est encore en attente, l’annulation entraîne son rejet avec le motif d’annulation. Si la promesse a déjà été tenue avec un objet Response, l’annulation ne peut pas la faire rejeter après coup, mais elle peut encore interrompre la lecture du corps de la réponse. Cela n’annule pas les actions effectuées sur le serveur.
L’exemple annule le signal avant d’appeler fetch, ce qui évite que le résultat dépende du réseau. Il s’agit d’une API Web, et non d’une fonctionnalité ECMAScript ; la présence de Node 24 dans le dépôt ne démontre pas la prise en charge par les navigateurs.
Exemples
async function main() {
const controller = new AbortController();
const signal = controller.signal;
const reason = new Error("Stopped");
controller.abort(reason);
try {
await fetch("data:text/plain,hello", { signal });
} catch (error) {
console.log(signal.aborted);
console.log(error === reason);
}
}
main();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.