HTMLMediaElement: suspend-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 suspend-Ereignis wird ausgelöst, wenn der User-Agent absichtlich keine Mediendaten abruft. In diesem Fall wird HTMLMediaElement.networkState auf HTMLMediaElement.NETWORK_IDLE gesetzt. Dies kann geschehen, wenn keine weiteren Daten geladen werden müssen oder das Laden nicht erforderlich ist. Beispielsweise kann der Browser entscheiden, nur die nächsten 5 Minuten eines Videos vorab zu puffern. Das Laden wird dann ausgesetzt, bis die nutzende Person einen weiteren Teil des Videos ansieht.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht nach oben weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("suspend", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onsuspend = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
Diese Beispiele fügen einen Event-Listener für das suspend-Ereignis des HTMLMediaElement hinzu und geben eine Meldung aus, wenn der Event-Handler auf das ausgelöste Ereignis reagiert hat.
Mit addEventListener():
const video = document.querySelector("video");
video.addEventListener("suspend", (event) => {
console.log("Data loading has been suspended.");
});
Mit der Event-Handler-Eigenschaft onsuspend (beachten Sie jedoch, dass dadurch gegebenenfalls andere über onsuspend hinzugefügte Event-Listener ersetzt werden):
const video = document.querySelector("video");
video.onsuspend = (event) => {
console.log("Data loading has been suspended.");
};
Spezifikationen
| Spezifikation |
|---|
| HTML # event-media-suspend |
| HTML # handler-onsuspend |
Browser-Kompatibilität
Verwandte Ereignisse
- Das
playing-Ereignis von HTMLMediaElement - Das
waiting-Ereignis von HTMLMediaElement - Das
seeking-Ereignis von HTMLMediaElement - Das
seeked-Ereignis von HTMLMediaElement - Das
ended-Ereignis von HTMLMediaElement - Das
loadedmetadata-Ereignis von HTMLMediaElement - Das
loadeddata-Ereignis von HTMLMediaElement - Das
canplay-Ereignis von HTMLMediaElement - Das
canplaythrough-Ereignis von HTMLMediaElement - Das
durationchange-Ereignis von HTMLMediaElement - Das
timeupdate-Ereignis von HTMLMediaElement - Das
play-Ereignis von HTMLMediaElement - Das
pause-Ereignis von HTMLMediaElement - Das
ratechange-Ereignis von HTMLMediaElement - Das
volumechange-Ereignis von HTMLMediaElement - Das
emptied-Ereignis von HTMLMediaElement - Das
stalled-Ereignis von HTMLMediaElement