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

WakeLock:request() 方法

· 52CE 我爱测

WakeLock 接口的 **`request()`** 方法用于请求系统屏幕唤醒锁。如果请求成功,该方法会返回一个兑现为 WakeLockSentinel 对象的 Promise。

Screen Wake Lock API

WakeLock 接口的 request() 方法用于请求系统屏幕唤醒锁。如果请求成功,该方法会返回一个兑现为 WakeLockSentinel 对象的 Promise。

屏幕唤醒锁可阻止设备屏幕在应用程序中需要保持运行时变暗或锁定。

语法

request(type)

参数

  • type
    • : 屏幕唤醒锁类型是一个字符串,用于指定屏幕唤醒锁的类型:
      • screen
        • : 阻止屏幕关闭,只有可见文档才能获取屏幕唤醒锁。

如果未明确指定 type 参数,request() 方法会默认使用 screen 类型。

返回值

一个 Promise 对象,它将解析为一个 WakeLockSentinel 对象。

异常

  • NotAllowedError DOMException
    • : 当无法获取屏幕唤醒锁时抛出异常,可能有以下原因:
      • 使用此功能被权限策略阻止。
      • 文档未完全激活。
      • 文档的可见性状态为 hidden。
      • User Agent无法获取平台的屏幕唤醒锁。例如设备电池电量过低。

示例

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

const requestWakeLock = async () => {
  try {
    const wakeLock = await navigator.wakeLock.request("screen");
  } catch (err) {
    // 唤醒锁请求失败——通常是系统原因,例如设备电量不足
    console.log(`${err.name}, ${err.message}`);
  }
};

requestWakeLock();

设备可能会在授予屏幕唤醒锁后撤销它,返回的 WakeLockSentinel 对象可用于检查屏幕唤醒锁的状态,以及手动取消持有的屏幕唤醒锁。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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