AbortSignal : évènement abort
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2018.
Note : Cette fonctionnalité est disponible via les Web Workers.
L'évènement abort de l'interface AbortSignal est déclenché lorsque la requête associée est annulée, c'est-à-dire via AbortController.abort().
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété gestionnaire d'évènement.
addEventListener("abort", (event) => { })
onabort = (event) => { }
Type d'évènement
Un Event générique sans propriété supplémentaire.
Exemples
Dans les extraits suivants, nous créons un nouvel objet AbortController et récupérons son AbortSignal (disponible via la propriété signal). Plus loin, nous vérifions si le signal a été annulé à l'aide d'une propriété gestionnaire d'évènement.
Vous pouvez détecter l'évènement abort avec la méthode addEventListener :
const controller = new AbortController();
const signal = controller.signal;
signal.addEventListener("abort", () => {
console.log("Requête annulée");
});
Ou utiliser la propriété gestionnaire d'évènement onabort :
const controller = new AbortController();
const signal = controller.signal;
signal.onabort = () => {
console.log("Requête annulée");
};
Spécifications
| Specification |
|---|
| DOM # eventdef-abortsignal-abort |
| DOM # abortsignal-onabort |