專案裡有個需求:要掌握頁面上所有影片的播放狀態,並把事件寫成 LOG 以便追蹤。HTML5 的 video 元素提供了完整的事件模型,搭配 addEventListener 就能全部攔下來。
<!DOCTYPE html> <html> <head> <meta http-equiv="content-type" content="text/html; charset=UTF-8"> <title>Multi Source</title> </head> <body> <video src="https://www.w3school.com.cn/i/movie.mp4" controls autoplay></video> <video src="https://www.w3school.com.cn/i/movie.mp4" controls autoplay></video> <video src="https://www.w3school.com.cn/i/movie.mp4" controls autoplay></video> </body> </html>
<script type="text/javascript">
window.addEventListener("load", getVideoEvent);
function getVideoEvent() {
var videoes = document.getElementsByTagName("video");
for (var i = 0; i < videoes.length; i++) {
showEventLog("video" + (i + 1), videoes[i]);
}
}
function showEventLog(videoNum, Media) {
function eventTester(e) {
Media.addEventListener(e, function () {
console.log(videoNum + ":" + e);
});
}
eventTester("loadstart"); // 開始請求資料
eventTester("progress"); // 正在下載
eventTester("suspend"); // 下載延遲
eventTester("abort"); // 主動中止(非錯誤導致)
eventTester("error"); // 請求時發生錯誤
eventTester("stalled"); // 網路失速
eventTester(" emptied"); // 播放清單被清空
eventTester("play"); // play() 或 autoplay 觸發
eventTester("pause"); // pause() 觸發
eventTester("loadedmetadata"); // 已取得長度等中介資料
eventTester("loadeddata"); // 目前位置的第一影格已載入
eventTester("waiting"); // 等待資料,非錯誤
eventTester("playing"); // 實際開始播放
eventTester("canplay"); // 可播放,但中途可能再暫停
eventTester("canplaythrough"); // 預估可順暢播完
eventTester("seeking"); // 正在跳轉
eventTester("seeked"); // 跳轉完成
eventTester("timeupdate"); // 播放進度改變
eventTester("ended"); // 播放結束
eventTester("ratechange"); // 播放速率改變
eventTester("durationchange"); // 總長度改變
eventTester("volumechange"); // 音量改變
}
</script>
事件順序值得記住:一次正常的播放大致是 loadstart → durationchange → loadedmetadata → loadeddata → canplay → canplaythrough → play → playing。若你要顯示 loading 指示器,該監聽的是 waiting(開始等)與 playing(恢復播放),而不是 loadstart。
timeupdate 的觸發頻率不固定:它大約每 250 毫秒觸發一次,但各家瀏覽器實作不一,且會被系統負載影響。若你需要平滑的進度條,別只依賴它,改用 requestAnimationFrame 讀取 video.currentTime 會順得多。
不要把監聽掛在 window 上就不管:video 被移除時事件監聽不會自動清掉,長時間存在的單頁應用容易累積。元件卸載時記得 removeEventListener。
autoplay 政策:現代瀏覽器限制自動播放,只有靜音影片(muted)才能直接自動播放,否則會被攔下並觸發 error 或停在 canplay。範例裡多個 video 同時 autoplay 在真實環境幾乎一定會失敗,實作時請搭配 muted 或改由使用者點擊觸發。
最後,若日誌要送到後端而非只印在 console,記得做批次與節流處理。像 timeupdate 這種高頻事件直接打 API 會產生大量請求,應該累積後每數秒回報一次,或用 navigator.sendBeacon 在頁面關閉前送出。