WakeLockSentinel: release() 方法

基準線 2025
新推出

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

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

WakeLockSentinel 介面的 release() 方法釋放 WakeLockSentinel,返回一個 Promise,該 Promise 在喚醒鎖哨兵成功釋放後解決。

語法

js
release()

引數

無。

返回值

返回一個解析為 undefinedPromise

異常

此方法不丟擲異常。您應該始終監聽 release 事件來檢查喚醒鎖是否已被釋放。

示例

在此示例中,當用戶單擊按鈕時,WakeLockSentinel 被釋放。

js
wakeLockOffButton.addEventListener("click", () => {
  WakeLockSentinel.release();
});

規範

規範
Screen Wake Lock API
# the-release-method

瀏覽器相容性

另見