XMLHttpRequest : méthode abort()

Baseline

Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

Voir la compatibilité complète
En savoir plus

Note : Cette fonctionnalité est disponible via les Web Workers, sauf pour les Service Workers.

La méthode abort() de l'interface XMLHttpRequest interrompt la requête si elle a déjà été envoyée. Lorsque la requête est interrompue, son readyState est changé en XMLHttpRequest.UNSENT (0) et le code status de la requête est défini sur 0.

Si la requête est toujours en cours (son readyState n'est ni XMLHttpRequest.DONE ni XMLHttpRequest.UNSENT), un évènement readystatechange, un évènement abort et un évènement loadend sont déclenchés, dans cet ordre. Pour les requêtes synchrones, aucun évènement n'est déclenché et une erreur est levée à la place.

Syntaxe

abort()

const xhr = new XMLHttpRequest();
const methode = "GET";
const url = "https://developer.mozilla.org/";
xhr.open(methode, url, true);

xhr.send();

if (OH_NOES_WE_NEED_TO_CANCEL_RIGHT_NOW_OR_ELSE) {
  xhr.abort();
}