This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The canplay event is fired when the user agent can play the media, but estimates that not enough data has been loaded to play the media up to its end without having to stop for further buffering of content.
This event is not cancelable and does not bubble.
Use the event name in methods like addEventListener(), or set an event handler property.
addEventListener("canplay", (event) => { })
oncanplay = (event) => { }
A generic Event.
These examples add an event listener for the HTMLMediaElement's canplay event, then post a message when that event handler has reacted to the event firing.
Using addEventListener():
const video = document.querySelector("video");
video.addEventListener("canplay", (event) => {
console.log("Video can start, but not sure it will play through.");
});
Using the oncanplay event handler property:
const video = document.querySelector("video");
video.oncanplay = (event) => {
console.log("Video can start, but not sure it will play through.");
};
| Specification |
|---|
| HTML> # event-media-canplay> |
| HTML> # handler-oncanplay> |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
canplay_event |
3 | 12 | 3.5 | 10.5 | 3.1 | 18 | 4 | 11 | 3 | 1.0 | 4.4 | 3 |
playing eventwaiting eventseeking eventseeked eventended eventloadedmetadata eventloadeddata eventcanplaythrough eventdurationchange eventtimeupdate eventplay eventpause eventratechange eventvolumechange eventsuspend eventemptied eventstalled event
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/canplay_event