AbortSignal: abort-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Das abort-Ereignis eines AbortSignal wird ausgelöst, wenn die zugehörige Anfrage abgebrochen wird, beispielsweise durch AbortController.abort().
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("abort", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onabort = (event) => { }
Ereignistyp
Ein generisches Event ohne zusätzliche Eigenschaften.
Beispiele
In den folgenden Codeausschnitten erstellen wir ein neues AbortController-Objekt und greifen auf dessen AbortSignal zu, das über die Eigenschaft signal verfügbar ist. Später prüfen wir mithilfe einer Event-Handler-Eigenschaft, ob das Signal abgebrochen wurde.
Sie können das abort-Ereignis mit der Methode addEventListener erkennen:
const controller = new AbortController();
const signal = controller.signal;
signal.addEventListener("abort", () => {
console.log("Request aborted");
});
Oder Sie verwenden die Event-Handler-Eigenschaft onabort. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über onabort hinzugefügte Event-Listener ersetzt werden:
const controller = new AbortController();
const signal = controller.signal;
signal.onabort = () => {
console.log("Request aborted");
};
Spezifikationen
| Spezifikation |
|---|
| DOM # eventdef-abortsignal-abort |
| DOM # abortsignal-onabort |