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

浏览器兼容性

另见