HTMLMediaElement: waiting event

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.

The waiting event is fired when playback has stopped because of a temporary lack of data.

This event is not cancelable and does not bubble.

Syntax

Use the event name in addEventListener():

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

Alternatively, assign to the event handler property of the interface:

js
onwaiting = (event) => { }

Event type

A generic Event.

Examples

These examples add an event listener for the HTMLMediaElement's waiting event, then post a message when that event handler has reacted to the event firing.

Using addEventListener():

js
const video = document.querySelector("video");

video.addEventListener("waiting", (event) => {
  console.log("Video is waiting for more data.");
});

Using the onwaiting event handler property (but note that this replaces other event listeners added using onwaiting, if any):

js
const video = document.querySelector("video");

video.onwaiting = (event) => {
  console.log("Video is waiting for more data.");
};

Specifications

Specification
HTML
# event-media-waiting
HTML
# handler-onwaiting

Browser compatibility

See also