我們的志工尚未將此文章翻譯為 正體中文 (繁體) 版本。加入我們,幫忙翻譯!
The ended
event is fired when playback or streaming has stopped because the end of the media was reached or because no further data is available.
This event occurs in two related but unique contexts:
- Elements based upon
HTMLMediaElement
(<audio>
and<video>
) fireended
when playback of the media reaches the end of the media. - Media strams' tracks, which are based on the
MediaStreamTrack
interface, fireended
when the track's source permanently stops sending data on the stream. There are various ways this can happen, including:- There is no more data left to send.
- The user revoked the permissions needed for the data to be sent.
- The hardware generating the source data has been removed or ejected.
- A remote peer has permanently stopped sending data; pausing media does not generate an
ended
event.
General info
- Specification
- HTML5 media and Media Capture and Streams
- Interface
- Event
- Bubbles
- No
- Cancelable
- No
- Target
- Element
- Default Action
- None.
While this event is defined in two specifications, at this time both specify this event identically, so we have documented them as if they were one. If at some point that changes, the documentation will be revised.
Properties
Property | Type | Description |
---|---|---|
target Read only |
EventTarget |
The event target (the topmost target in the DOM tree). |
type Read only |
DOMString |
The type of event. |
bubbles Read only |
Boolean |
Whether the event normally bubbles or not |
cancelable Read only |
Boolean |
Whether the event is cancellable or not? |