HTMLMediaElement: ended Ereignis

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das ended-Ereignis wird ausgelöst, wenn die Wiedergabe oder das Streaming gestoppt wurde, weil das Ende des Mediums erreicht wurde oder weil keine weiteren Daten verfügbar sind.

Dieses Ereignis tritt auf, basierend auf HTMLMediaElement (<audio> und <video>), die ended auslösen, wenn die Wiedergabe das Ende des Mediums erreicht.

Dieses Ereignis ist nicht abbrechbar und propagiert nicht.

Hinweis: Das ended-Ereignis wird nicht ausgelöst, wenn die loop-Eigenschaft true ist und playbackRate nicht negativ ist.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("ended", (event) => { })

onended = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Diese Beispiele fügen einen Ereignislistener für das ended-Ereignis des HTMLMediaElements hinzu und senden dann eine Nachricht, wenn dieser Ereignishandler auf das Auslösen des Ereignisses reagiert hat.

Verwendung von addEventListener():

js
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.",
  );
});

Verwendung der onended-Ereignishandler-Eigenschaft:

js
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

Specification
HTML
# event-media-ended
HTML
# handler-onended

Browser-Kompatibilität

Verwandte Ereignisse

Siehe auch