md` ### Options

\`duration\`: length of the media in seconds. Defaults to \`1\`. Same as [HTMLMediaElement.duration](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/duration).
\`currentTime\`: current playback time in seconds. Defaults to \`0\`. Same as [HTMLMediaElement.currentTime](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/currentTime).
\`autoplay\`: indicates whether playback should automatically begin. Defaults to \`false\`. Same as [HTMLMediaElement.autoplay](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/autoplay).
\`loop\`: controls whether the media element should start over when it reaches the end. Defaults to \`false\`. Same as [HTMLMediaElement.loop](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/loop).
\`playbackRate\`: sets the rate at which the media is being played back. Defaults to \`1.0\`. Same as [HTMLMediaElement.playbackRate](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/playbackRate).
\`defaultPlaybackRate\`: indicates the default playback rate for the media. Defaults to \`1.0\`. Same as [HTMLMediaElement.defaultPlaybackRate](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/defaultPlaybackRate). Note that setting defaultPlaybackRate has no effect on the play rate, as stated by the standard.
\`delay\`: approximate time in milliseconds between two successive \`timeupdate\` events. Defaults to 200
\`invalidation\`: an optional promise that will dispose of the internal resources if resolved. Defaults to undefined
\`onstep\`: a function that is called on _every animation frame_ while playing the media, and when currentTime is set. It is passed the currentTime as an argument: \`onstep(t)\`. It makes sense to use it to animate the element at every time t. Beware, it's called synchronously and might interfere with the internal timer if it takes time. Defaults to undefined.
\`ontimeupdate\`: a function that is called on _every \`timeupdate\` event_, which occur every \`delay\` milliseconds approximately while playing, and when currentTime is set manually. It is passed the currentTime as an argument: \`ontimeupdate(t)\`. It makes sense to use it to animate the element at a slower rate than whith \`onstep\`. Control the update frequency with \`delay\`. Beware, it's called synchronously and might interfere with the internal timer if it takes time. Defaults to undefined.

### Properties All options can be get and set as properties of the media as with [HTMLMediaElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement), for example: ~~~js element.loop = false; const t = element.duration; element.currentTime = 3 ~~~ Other properties:

\`paused\`: _read-only_. tells whether the media is paused. Same as [HTMLMediaElement.paused](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/paused).

### Methods

\`pause()\`: pause playback of the media. If it is already in a paused state this method will have no effect. Same as [HTMLMediaElement.pause()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/pause).
\`play()\`: attempts to begin playback of the media (it will always succeed, contrarily to HTMLMediaElement.play()). It returns a Promise which is resolved when playback has been successfully started (always). Same as [HTMLMediaElement.play()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/play).

### Events

\`ended\`: fired when playback or streaming has stopped because the end of the media was reached. Same as [HTMLMediaElement ended event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/ended_event).
\`pause\`: sent when a request to pause an activity is handled and the activity has entered its paused state, most commonly after the media has been paused through a call to the pause() method. Same as [HTMLMediaElement pause event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/pause_event).
\`play\`: fired when the paused property is changed from true to false, as a result of the play() method, or the autoplay attribute. Same as [HTMLMediaElement play event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/play_event).
\`ratechange\`: fired when the playback rate has changed. Same as [HTMLMediaElement ratechange event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/ratechange_event).
\`timeupdate\`: fired when the time indicated by the currentTime attribute has been updated. Same as [HTMLMediaElement timeupdate event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/timeupdate_event).
\`durationchange\`: fired when the duration attribute has been updated. Same as [HTMLMediaElement durationchange event](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/durationchange_event).