WakeLock

基準線 2025
新推出

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

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

WakeLock 介面屬於 Screen Wake Lock API,可用於請求鎖定,防止裝置螢幕在應用程式需要保持執行時變暗或鎖定。

此介面以及系統喚醒鎖透過 Navigator.wakeLock 屬性公開。

例項方法

request()

如果螢幕喚醒鎖被授予,則返回一個 Promise,該 Promise 將解析為 WakeLockSentinel 物件。

示例

以下程式碼 awaits 請求 WakeLockSentinel 物件,如果請求被授予則繼續執行。

WakeLock.request() 方法被包裝在一個 try...catch 語句中,用於捕獲 promise 可能被拒絕的情況,例如由於裝置電量不足。

js
try {
  const wakeLock = await navigator.wakeLock.request("screen");
} catch (err) {
  // the wake lock request fails - usually system related, such being low on battery
  console.log(`${err.name}, ${err.message}`);
}

請注意,螢幕喚醒鎖在被授予後可能會被裝置撤銷。返回的 WakeLockSentinel 可用於檢查鎖的狀態,和/或手動取消已持有的螢幕喚醒鎖。

規範

規範
Screen Wake Lock API
# the-wakelock-interface

瀏覽器相容性

另見