HTMLMediaElement: ended-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 ended-Ereignis wird ausgelöst, wenn die Wiedergabe oder das Streaming beendet wurde, weil das Ende des Mediums erreicht wurde oder keine weiteren Daten verfügbar sind.
Dieses Ereignis wird bei HTMLMediaElement (<audio> und <video>) ausgelöst, wenn die Wiedergabe das Ende des Mediums erreicht.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht nach oben weitergegeben.
Hinweis:
Das ended-Ereignis wird nicht ausgelöst, wenn die Eigenschaft loop den Wert true hat und playbackRate nicht negativ ist.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("ended", (event) => { })
Alternativ können Sie ihn der Ereignisbehandlungs-Eigenschaft der Schnittstelle zuweisen:
onended = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
Diese Beispiele fügen einen Ereignis-Listener für das ended-Ereignis von HTMLMediaElement hinzu und geben eine Meldung aus, wenn der Ereignis-Handler auf das Auslösen des Ereignisses reagiert hat.
Mit addEventListener():
const video = document.querySelector("video");
video.addEventListener("ended", (event) => {
console.log(
"Video stopped either because it has finished playing or no further data is available.",
);
});
Mit der Ereignisbehandlungs-Eigenschaft onended (beachten Sie jedoch, dass dadurch gegebenenfalls andere mit onended hinzugefügte Ereignis-Listener ersetzt werden):
const video = document.querySelector("video");
video.onended = (event) => {
console.log(
"Video stopped either because it has finished playing or no further data is available.",
);
};
Spezifikationen
| Spezifikation |
|---|
| HTML> # event-media-ended> |
| HTML> # handler-onended> |
Browser-Kompatibilität
Verwandte Ereignisse
- Das HTMLMediaElement-Ereignis
playing - Das HTMLMediaElement-Ereignis
waiting - Das HTMLMediaElement-Ereignis
seeking - Das HTMLMediaElement-Ereignis
seeked - Das HTMLMediaElement-Ereignis
loadedmetadata - Das HTMLMediaElement-Ereignis
loadeddata - Das HTMLMediaElement-Ereignis
canplay - Das HTMLMediaElement-Ereignis
canplaythrough - Das HTMLMediaElement-Ereignis
durationchange - Das HTMLMediaElement-Ereignis
timeupdate - Das HTMLMediaElement-Ereignis
play - Das HTMLMediaElement-Ereignis
pause - Das HTMLMediaElement-Ereignis
ratechange - Das HTMLMediaElement-Ereignis
volumechange - Das HTMLMediaElement-Ereignis
suspend - Das HTMLMediaElement-Ereignis
emptied - Das HTMLMediaElement-Ereignis
stalled