Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources