HTMLMediaElement: abort-Ereignis
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.
Das abort-Ereignis wird ausgelöst, wenn das Laden einer Medienressource vor dem Abschluss beendet wird, ohne dass ein Fehler die Ursache ist.
Dies geschieht üblicherweise, indem das src-Attribut entfernt oder auf eine leere Zeichenfolge ("") gesetzt und anschließend load() aufgerufen wird.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.
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.
Beispiele
Laden einer Medienressource abbrechen
Das folgende Beispiel zeigt, wie Sie das Laden eines Videos abbrechen.
Wenn Sie die Schaltfläche drücken, beginnt das Laden einer Videoressource.
Nach einer kurzen Wartezeit wird das Laden abgebrochen, indem das src-Attribut entfernt und die Methode load() aufgerufen wird.
Falls die Videoressource noch geladen wird, wenn load() aufgerufen wird, wird das abort-Ereignis ausgelöst.
HTML
<video controls width="250"></video>
<button id="loadAndAbort">Load and abort video</button>
<pre id="log"></pre>
CSS
video,
button,
pre {
display: block;
margin-block: 1rem;
}
JavaScript
const video = document.querySelector("video");
const loadAndAbortButton = document.querySelector("#loadAndAbort");
const log = document.querySelector("#log");
video.addEventListener("abort", () => {
log.textContent += "Video loading aborted\n";
});
loadAndAbortButton.addEventListener("click", () => {
log.textContent = "Loading video...\n";
video.src = `/shared-assets/videos/flower.webm?nocache=${Date.now()}`;
video.load();
setTimeout(() => {
video.removeAttribute("src");
video.load();
}, 50);
});
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| HTML # event-media-abort |
| HTML # handler-onabort |