/Web APIs

HTMLMediaElement: canplay event

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) => {};

Event type

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


Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
canplay_event 3 12 3.5 9 10.5 3.1 ≤37 18 4 11 3 1.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.