WakeLock
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
屏幕唤醒锁 API 的 WakeLock
接口可用于请求锁,该锁阻止设备屏幕在应用程序需要保持运行时变暗或锁定。
此接口以及系统唤醒锁通过 Navigator.wakeLock
属性暴露。
实例方法
request()
-
返回一个
Promise
对象,该对象在屏幕唤醒锁被授予时会兑现为一个WakeLockSentinel
对象。
示例
以下代码使用了 await
来请求 WakeLockSentinel
对象,如果请求成功则继续执行。
WakeLock.request()
方法被包裹在 try...catch
语句中,以捕捉导致 promise 被拒绝的情况,例如设备电量低。
js
try {
const wakeLock = await navigator.wakeLock.request("screen");
} catch (err) {
// 唤醒锁请求失败——通常是系统原因,例如设备电量不足
console.log(`${err.name}, ${err.message}`);
}
请注意,设备可能会在授予屏幕唤醒锁后撤销它。返回的 WakeLockSentinel
可用于检查锁的状态,以及手动取消持有的屏幕唤醒锁。
规范
Specification |
---|
Screen Wake Lock API # the-wakelock-interface |
浏览器兼容性
BCD tables only load in the browser