WakeLock.request()

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

安全上下文: 此项功能仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

WakeLock.request() 方法用来获取屏幕唤醒锁定权限，防止屏幕变暗、关闭或展示屏幕保护程序。

语法

WakeLock.request(wakeLockType)

参数

wakeLockType

唤醒锁定类型，目前必须传 "screen" 。

返回值

决议为 WakeLockSentinel 的 Promise。

异常

NotAllowedError

当唤醒锁定不可用的时候抛出，例如在：

  • 由于屏幕唤醒锁定策略，Document 不允许使用屏幕唤醒锁定。
  • Document 不完全激活。
  • Document 被隐藏。
  • User Agent 无法获取平台的唤醒锁定。

示例

以下示例获取屏幕唤醒锁定并在 10 分钟后释放它：

function tryKeepScreenAlive(minutes) {
  navigator.wakeLock.request("screen").then(lock => {
    setTimeout(() => lock.release(), minutes * 60 * 1000);
  });
}

tryKeepScreenAlive(10);

规范

Specification
Screen Wake Lock API
# the-request-method

浏览器兼容性

BCD tables only load in the browser

相关链接