XMLHttpRequest: abort()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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.

Syntax

js
abort()

Parameter

Keine.

Rückgabewert

Keine (undefined).

Beispiele

Dieses Beispiel beginnt mit dem Laden von Inhalten von der MDN-Homepage und bricht dann aufgrund einer bestimmten Bedingung den Transfer durch Aufrufen von abort() ab.

js
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();
}

Spezifikationen

Specification
XMLHttpRequest Standard
# the-abort()-method

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch