WakeLock.request()

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

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

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

语法

WakeLock.request(wakeLockType)

参数

wakeLockType

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

返回值

决议为 WakeLockSentinelPromise

异常

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

相关链接