大网数据广告活动
Web 标准与前端开发

WakeLockSentinel

· 52CE 我爱测

The **`WakeLockSentinel`** interface of the Screen Wake Lock API can be used to monitor the status of the platform screen wake lock, and manually release the lock when needed.

Screen Wake Lock API

The WakeLockSentinel interface of the Screen Wake Lock API can be used to monitor the status of the platform screen wake lock, and manually release the lock when needed.

The screen wake lock prevents device screens from dimming or locking when an application needs to keep running.

A screen wake lock is requested using the WakeLock.request() method, which returns a Promise that fulfills with a WakeLockSentinel object if the lock is granted.

An acquired screen wake lock can be released manually via the WakeLockSentinel.release method, or automatically via the platform screen wake lock. The latter may occur if the document becomes inactive or loses visibility, if the device is low on power, or if the user turns on a power save mode. A released WakeLockSentinel cannot be re-used: a new sentinel must be requested using WakeLock.request() if a new lock is needed. Releasing all WakeLockSentinel instances of a given wake lock type will cause the underlying platform wake lock to be released.

An event is fired at the WakeLockSentinel if the platform lock is released, allowing applications to configure their UI, and re-request the lock if needed.

Instance properties

Also inherits properties from its parent interface, EventTarget.

  • WakeLockSentinel.released
    • : Returns a boolean indicating whether the WakeLockSentinel has been released.
  • WakeLockSentinel.type
    • : Returns a string representation of the currently acquired WakeLockSentinel type. Return values are:
      • screen: A screen wake lock. Prevents devices from dimming or locking the screen.

Instance methods

Also inherits methods from its parent interface, EventTarget.

  • WakeLockSentinel.release()
    • : Releases the WakeLockSentinel, returning a Promise that is resolved once the sentinel has been successfully released.

Events

  • WakeLockSentinel.release_event
    • : Fired when the WakeLockSentinel.release method is called or the wake lock is released by the user agent.

Examples

In this example, we create an asynchronous function that requests a WakeLockSentinel. Once the screen wake lock is acquired we listen for the release event, which can be used to give appropriate UI feedback. The sentinel can be acquired or released via appropriate interactions.

// create a reference for the wake lock
let wakeLock = null;

// create an async function to request a wake lock
const requestWakeLock = async () => {
  try {
    wakeLock = await navigator.wakeLock.request("screen");

    // listen for our release event
    wakeLock.addEventListener("release", () => {
      // if wake lock is released alter the UI accordingly
    });
  } catch (err) {
    // if wake lock request fails - usually system related, such as battery
  }
};

wakeLockOnButton.addEventListener("click", () => {
  requestWakeLock();
});

wakeLockOffButton.addEventListener("click", () => {
  if (wakeLock !== null) {
    wakeLock.release().then(() => {
      wakeLock = null;
    });
  }
});

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。