Screen Wake Lock API
WakeLock 接口的 request() 方法用于请求系统屏幕唤醒锁。如果请求成功,该方法会返回一个兑现为 WakeLockSentinel 对象的 Promise。
屏幕唤醒锁可阻止设备屏幕在应用程序中需要保持运行时变暗或锁定。
语法
request(type)
参数
type- : 屏幕唤醒锁类型是一个字符串,用于指定屏幕唤醒锁的类型:
screen- : 阻止屏幕关闭,只有可见文档才能获取屏幕唤醒锁。
- : 屏幕唤醒锁类型是一个字符串,用于指定屏幕唤醒锁的类型:
如果未明确指定 type 参数,request() 方法会默认使用 screen 类型。
返回值
一个 Promise 对象,它将解析为一个 WakeLockSentinel 对象。
异常
NotAllowedErrorDOMException- : 当无法获取屏幕唤醒锁时抛出异常,可能有以下原因:
- 使用此功能被权限策略阻止。
- 文档未完全激活。
- 文档的可见性状态为
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。离线整理了版式、链接和媒体显示。
