WakeLock
Baseline
2025
最近利用可能
March 2025以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
WakeLock は画面起動ロック API のインターフェイスで、アプリケーションが動作し続ける必要があるときに、端末の画面が暗くなったりロックされたりすることを防ぐためのものです。
システムの起動ロックはグローバルの Navigator.wakeLock プロパティで公開されています。
メソッド
request-
WakeLockSentinelオブジェクトを要求し、WakeLockSentinelオブジェクトで解決するPromiseを返します。
例
以下の非同期関数は、 WakeLockSentinel オブジェクトを要求します。WakeLock.request メソッドはブラウザーが何らかの理由でリクエストを拒否した場合を想定して、 try...catch 文で囲まれています。
js
try {
const wakeLock = await navigator.wakeLock.request("screen");
} catch (err) {
// 起動ロックの要求に失敗 - 通常は、バッテリー低下などシステムに起因する。
console.log(`${err.name}, ${err.message}`);
}
仕様書
| 仕様書 |
|---|
| Screen Wake Lock API # the-wakelock-interface |