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

WakeLock

· 52CE 我爱测

屏幕唤醒锁 API 的 **`WakeLock`** 接口可用于请求锁,该锁阻止设备屏幕在应用程序需要保持运行时变暗或锁定。

Screen Wake Lock API

屏幕唤醒锁 API 的 WakeLock 接口可用于请求锁,该锁阻止设备屏幕在应用程序需要保持运行时变暗或锁定。

此接口以及系统唤醒锁通过 Navigator.wakeLock 属性暴露。

实例方法

  • WakeLock.request
    • : 返回一个 Promise 对象,该对象在屏幕唤醒锁被授予时会兑现为一个 WakeLockSentinel 对象。

示例

以下代码使用了 await 来请求 WakeLockSentinel 对象,如果请求成功则继续执行。

WakeLock.request 方法被包裹在 try...catch 语句中,以捕捉导致 promise 被拒绝的情况,例如设备电量低。

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

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

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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