WakeLock
Baseline
2025
Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Giao diện WakeLock của Screen Wake Lock API có thể được dùng để yêu cầu một khóa ngăn màn hình thiết bị bị mờ hoặc khóa khi ứng dụng cần tiếp tục chạy.
Giao diện này, và do đó cả khóa wake của hệ thống, được truy cập thông qua thuộc tính Navigator.wakeLock.
Phương thức phiên bản
request()-
Trả về một
Promiseđược hoàn thành với một đối tượngWakeLockSentinelnếu khóa wake màn hình được cấp phép.
Ví dụ
Đoạn mã sau await yêu cầu một đối tượng WakeLockSentinel và tiếp tục nếu yêu cầu được chấp thuận.
Phương thức WakeLock.request() được bao bọc trong câu lệnh try...catch để bắt các trường hợp khi promise có thể bị từ chối, chẳng hạn do mức pin thiết bị thấp.
try {
const wakeLock = await navigator.wakeLock.request("screen");
} catch (err) {
// the wake lock request fails - usually system related, such being low on battery
console.log(`${err.name}, ${err.message}`);
}
Lưu ý rằng khóa wake màn hình có thể bị thiết bị thu hồi sau khi đã được cấp.
WakeLockSentinel được trả về có thể được dùng để kiểm tra trạng thái của khóa và/hoặc để hủy thủ công một khóa wake màn hình đang được giữ.
Thông số kỹ thuật
| Specification |
|---|
| Screen Wake Lock API # the-wakelock-interface |