1. Web
  2. Web API
  3. HTMLMediaElement
  4. suspend

HTMLMediaElement: suspend 事件

Baseline 已廣泛支援

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

當用戶代理（User Agent）有意不獲取媒體資料時，會觸發 suspend 事件。在這種情況下，HTMLMediaElement.networkState 會被設定為 HTMLMediaElement.NETWORK_IDLE。這可能發生在沒有更多資料需要載入時，或者載入是不必要的時候；例如，瀏覽器可能會決定只預先緩衝 5 分鐘的影片，在這種情況下，載入將暫停，直到使用者觀看更多影片。

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

語法

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

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

onsuspend = (event) => { }

事件型別

一個通用的 Event。

示例

這些示例添加了一個 HTMLMediaElement 的 suspend 事件的事件監聽器，然後在該事件處理程式響應事件觸發後傳送一條訊息。

使用 addEventListener()

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

video.addEventListener("suspend", (event) => {
  console.log("Data loading has been suspended.");
});

使用 onsuspend 事件處理程式屬性

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

video.onsuspend = (event) => {
  console.log("Data loading has been suspended.");
};

規範

規範
HTML
# event-media-suspend
HTML
# handler-onsuspend

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ，由 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤
© . Content available under a Creative Commons license.