XMLHttpRequest: abort() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.

Die XMLHttpRequest.abort()-Methode bricht die Anfrage ab, wenn sie bereits gesendet wurde. Wenn eine Anfrage abgebrochen wird, ändert sich ihr readyState zu XMLHttpRequest.UNSENT (0) und der status-Code der Anfrage wird auf 0 gesetzt.

Wenn die Anfrage noch in Bearbeitung ist (ihr readyState ist nicht XMLHttpRequest.DONE oder XMLHttpRequest.UNSENT), werden in dieser Reihenfolge ein readystatechange-Ereignis, ein abort-Ereignis und ein loadend-Ereignis ausgelöst. Bei synchronen Anfragen werden keine Ereignisse ausgelöst, stattdessen wird ein Fehler geworfen.

Syntax

abort()

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

xhr.send();

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