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

瀏覽器相容性

另見