HTMLMediaElement: canplay event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("HTMLMediaElement")}}

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.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("canplay", (event) => { })

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

js-nolint
oncanplay = (event) => { }

Event type

A generic {{domxref("Event")}}.

Examples

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():

js
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 (but note that this replaces other event listeners added using oncanplay, if any):

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

video.oncanplay = (event) => {
  console.log("Video can start, but not sure it will play through.");
};

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

Related Events

  • The HTMLMediaElement {{domxref("HTMLMediaElement.playing_event", 'playing')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.waiting_event", 'waiting')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.seeking_event", 'seeking')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.seeked_event", 'seeked')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.ended_event", 'ended')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.loadedmetadata_event", 'loadedmetadata')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.loadeddata_event", 'loadeddata')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.canplaythrough_event", 'canplaythrough')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.durationchange_event", 'durationchange')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.timeupdate_event", 'timeupdate')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.play_event", 'play')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.pause_event", 'pause')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.ratechange_event", 'ratechange')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.volumechange_event", 'volumechange')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.suspend_event", 'suspend')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.emptied_event", 'emptied')}} event
  • The HTMLMediaElement {{domxref("HTMLMediaElement.stalled_event", 'stalled')}} event

See also

  • {{domxref("HTMLAudioElement")}}
  • {{domxref("HTMLVideoElement")}}
  • {{HTMLElement("audio")}}
  • {{HTMLElement("video")}}