WakeLock: request() 方法

type 可选

一个字符串，指定屏幕唤醒锁定类型，从以下枚举类型中选择

screen

防止屏幕关闭。只有可见的文档才能获取屏幕唤醒锁定。

如果没有显式指定type参数，则request()方法默认使用screen类型。

一个 Promise，它解析为一个 WakeLockSentinel 对象。

NotAllowedError DOMException

当唤醒锁定不可用时抛出，这可能发生在以下情况下

• 使用此功能被 权限策略 阻止。
• 文档未完全激活。
• 文档的可见性状态为hidden。
• 用户代理 无法获取平台的唤醒锁定。例如，如果设备电量不足，可能会发生这种情况。

以下异步函数请求一个 WakeLockSentinel 对象。request()方法被包装在一个try...catch语句中，以处理浏览器因任何原因拒绝请求的情况。

const requestWakeLock = async () => {
  try {
    const wakeLock = await navigator.wakeLock.request("screen");
  } catch (err) {
    // The wake lock request fails - usually system-related, such as low battery.

    console.log(`${err.name}, ${err.message}`);
  }
};

requestWakeLock();

屏幕唤醒锁定可能在授予后被设备撤销。返回的 WakeLockSentinel 可用于检查锁定的状态，或手动取消持有的屏幕唤醒锁定。

• 使用屏幕唤醒锁定 API 保持唤醒状态