Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 ⁨Juli 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.

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

js
abort()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Beispiele

Dieses Beispiel beginnt mit dem Laden von Inhalten von der MDN-Startseite, bricht den Transfer dann aber aufgrund einer bestimmten Bedingung durch Aufruf 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
# the-abort()-method

Browser-Kompatibilität

Siehe auch