HTMLMediaElement: canplay 事件

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

當用戶代理能夠播放媒體,但估計載入的資料量不足以播放到媒體結束而無需停止以進一步緩衝內容時,會觸發 canplay 事件。

此事件不可取消,也不會冒泡。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

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

oncanplay = (event) => { }

事件型別

一個通用的 Event

示例

這些示例為 HTMLMediaElement 的 canplay 事件添加了一個事件監聽器,然後在該事件處理程式響應事件觸發後釋出一條訊息。

使用 addEventListener()

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

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

使用 oncanplay 事件處理程式屬性

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

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

規範

規範
HTML
# event-media-canplay
HTML
# handler-oncanplay

瀏覽器相容性

另見