WakeLockSentinel: released 属性

基准线 2025
新推出

自 ⁨2025 年 3 月⁩ 起,此功能可在最新的设备和浏览器版本上使用。此功能可能在旧设备或浏览器上无法正常工作。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

releasedWakeLockSentinel 接口的一个只读属性,它返回一个布尔值,表示 WakeLockSentinel 是否已被释放。

当相关的平台屏幕唤醒锁被撤销时,WakeLockSentinel 就会被释放;之后 released 将始终返回 true。如果需要后续的屏幕唤醒锁,应用程序将需要请求一个新的屏幕唤醒锁(当前的 WakeLockSentinel 不能被重用)。

一个布尔值,直到 WakeLockSentinel 被释放(无论是通过调用 WakeLockSentinel.release() 还是因为锁自动释放)并且 release 事件被发出之后,它才变为 true,并且不再改变。

示例

此示例展示了 released 属性的值在 WakeLockSentinel 的生命周期内如何变化。

js
const sentinel = await navigator.wakeLock.request("screen");
console.log(sentinel.released); // Logs "false"

sentinel.onrelease = () => {
  console.log(sentinel.released); // Logs "true"
};

await sentinel.release();

规范

规范
Screen Wake Lock API
# dom-wakelocksentinel-released

浏览器兼容性

另见