WakeLock - 在应用程序需要继续运行时防止设备屏幕变暗或锁定

WakeLock 是 Screen Wake Lock API 的接口，可在应用程序需要继续运行时防止设备屏幕变暗或锁定。

系统唤醒锁通过全局的 Navigator.wakelock 属性获得。

方法

request

请求一个 WakeLockSentinel 对象，该方法返回一个 Promise，解析为 WakeLockSentinel 对象。

实例

下面的异步函数请求一个 WakeLockSentinel 对象。WakeLock.request 方法包装在一个 try...catch 语句中，用于检查浏览器是否由于什么原因拒绝了该请求。

try {
  const wakeLock = await navigator.wakeLock.request('screen');
} catch (err) {
  // 唤醒锁定请求失败 - 通常与系统有关，例如电池电量不足
  console.log(`${err.name}, ${err.message}`);
}

规范

规范	状态	备注
Screen Wake Lock API WakeLock 的定义	编者的草案	初始定义。

桌面浏览器兼容性

移动浏览器兼容性