WakeLockSentinel: release 事件

基準線 2025
新推出

自 ⁨2025 年 3 月⁩ 起,此功能可在最新的裝置和瀏覽器版本上使用。此功能可能在舊裝置或瀏覽器上無法正常工作。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

當 sentinel 物件的控制代碼被釋放時,WakeLockSentinel 介面的 release 事件就會觸發。

WakeLockSentinel 可以透過 release() 方法手動釋放,也可以透過平臺喚醒鎖自動釋放。如果文件變為非活動狀態或失去可見性,如果裝置電量不足或使用者開啟省電模式,則可能會發生這種情況。

語法

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

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

onrelease = (event) => { }

事件型別

一個通用的 Event

示例

此示例在喚醒鎖釋放時更新 UI。

js
wakeLock.addEventListener("release", () => {
  // if wake lock is released alter the UI accordingly
  statusElement.textContent = "Wake Lock has been released";
});

規範

規範
Screen Wake Lock API
# the-onrelease-attribute

瀏覽器相容性

另見