本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年4月4日(金)更新: 2026年11月9日(月)約8分で読めます

Screen Wake Lock APIで画面のスリープを防ぐ

Screen Wake Lock APIは、Webページから画面の消灯やスリープを止めるAPIです。レシピのように見ているのに触らないページで使います。wakeLock.request()の使い方と、タブに戻ったときの取り直し方を書きます。

Newly availableScreen wake lock2025年〜
  • Chrome84
  • Edge84
  • Firefox126
  • Safari16.4

はじめに

Screen Wake Lock APIは、ページを表示しているあいだ、端末の画面が暗くなったりスリープしたりするのを止めるAPIです。navigator.wakeLock.request('screen')でロックを取ると、タブを離れるかrelease()を呼ぶまで画面が点いたままになります。iOSのSafari 18.4が対応して、Baseline 2025に入りました。

レシピを見ながら料理するときのように、画面を見ているのに触らない場面では、OSの設定した時間で画面が暗くなります。Screen Wake Lock APIを使うと、ページの側から画面を点けたままにできます。

Screen Wake Lock APIによるスリープを体験する

Screen Wake Lock APIを使用してスリープのロックを要求するボタンを用意しました。

html
<button id="lock" type="button">スリープ機能をロックする</button>
結果

ボタンを押してロックを取ると、ボタンの文言がロックを解除する文言に切り替わります。

Macでは、標準のアクティビティモニタで確かめられます。エネルギーのタブを開くと、ロックしているあいだは、お使いのブラウザの行の非スリープの列がはいになります。

Macのアクティビティモニタのエネルギーの表でGoogle Chromeの非スリープの項目が「はい」になっている

ブラウザのタブを切り替えたり、スクリーンを畳んだりすると非スリープがいいえに変わります。

ボタンを押してから別のタブに切り替えて戻ってくると、ボタンの文言がロックする前の文言に戻っていることがわかります。

これは表示中のタブが有効な範囲でのみScreen Wake Lock APIが有効になり、有効範囲からはみ出るとロックが解除されるためです。

Macのターミナルからはpmset -g assertionsで確かめられます。ChromeとFirefoxでロックを取ると、ブラウザのプロセスにNoDisplaySleepAssertionの行が加わり、その名前はChromeではBlink Wake Lock、Firefoxではscreenです。Firefoxでは、別のタブに切り替えるとこの行が消えます。

Screen Wake Lock APIの使い方

Screen Wake Lock APIは、navigator.wakeLockから使用します。

navigator.wakeLock.request()メソッドを使用すると、画面のスリープを防ぐことを要求し、WakeLockSentinelインスタンスを返します。 このインスタンスは、ロックを解除するためのrelease()メソッドを持っています。

js
let wakeLock = null;

// 画面をロックする
wakeLock = await navigator.wakeLock.request('screen');

// 画面のロックを解除する
await wakeLock.release();

navigator.wakeLock.requestは画面のスリープを防ぐことを要求するメソッドです。

navigator.wakeLock.requestは第1引数にロックの種類を任意で渡せます。 指定できるのはscreenだけで、省略してもscreenになります。'system'のような別の値を渡すとTypeErrorになります。

戻り値はWakeLockSentinelインスタンスで解決するPromiseです。ロックを取れないときはNotAllowedErrorで拒否されます。たとえば次のときです。

  • タブが隠れているとき
  • allow="screen-wake-lock 'none'"を付けたiframeの中
  • ボタンを押すといったユーザーの操作を経ずに呼んだとき(Safariだけ)

Safariでは、ページを開いた直後に呼んでも、button.click()でスクリプトからクリックして呼んでも断られ、navigator.permissions.query({ name: 'screen-wake-lock' })はpromptを返します。ChromeとFirefoxはgrantedを返し、ページを開いた直後でもロックを取れます。Safariに対応するなら、デモのようにボタンを押したときにrequest()を呼ぶ形にします。

WakeLockSentinel

WakeLockSentinelインスタンスはreleasedプロパティとtypeプロパティ、release()メソッドを持ちます。

releasedプロパティはnavigator.wakeLock.requestによるロックが解除されているかどうかを示すプロパティで、typeプロパティはロックの種類を示します。

js
wakeLock.released; // false
wakeLock.type; // 'screen'

release()メソッドはnavigator.wakeLock.requestによるロックを解除するためのメソッドです。

js
// 画面のロックを解除する
await wakeLock.release();

WakeLockSentinelインスタンスは、addEventListenerでreleaseを指定して、navigator.wakeLock.requestによるロックが解除されたときに発火するイベントを登録できます。

js
const wakeLock = await navigator.wakeLock.request('screen');
// タブを切り替えるなど、何かしらの操作によるロックの解除を検知する
wakeLock.addEventListener('release', () => {
  console.log('Wake Lock was released');
});

releaseイベントは、そのインスタンスのロックが外れたことを知らせるだけで、画面のロックが外れたとは限りません。request()を2回呼び、片方だけrelease()すると、releaseは呼んだほうにだけ発火します。もう片方のreleasedはfalseのままです。ChromeとFirefoxでは、pmset -g assertionsの行も残ります。同じインスタンスのrelease()を2回呼んでもエラーにはならず、イベントも1回しか発火しません。

タブに戻ったときに取り直す

タブを離れるとロックは外れ、戻ってきても取り直されません。レシピのページのように見ているあいだずっと画面を点けておきたいときは、visibilitychangeでタブに戻ったことを知り、もう一度request()を呼びます。

js
let wakeLock = null;

const requestWakeLock = async () => {
  wakeLock = await navigator.wakeLock.request('screen');
};

button.addEventListener('click', requestWakeLock);

document.addEventListener('visibilitychange', async () => {
  if (wakeLock !== null && document.visibilityState === 'visible') {
    await requestWakeLock();
  }
});

Firefoxでは、別のタブに切り替えたときにvisibilitychange、releaseの順に発火し、隠れているあいだのrequest()はNotAllowedErrorで断られます。元のタブに戻るとvisibilitychangeの中で新しいロックが取れ、pmset -g assertionsの行も戻ります。Safariでは、ボタンを押さずに開いたページだと、タブに戻ったときのvisibilitychangeの中で呼んだrequest()もNotAllowedErrorで断られます。

おわりに

Screen Wake Lock APIを使うと、見ているのに触らないページで画面を点けたままにできます。ロックはタブを離れると外れ、Safariではユーザーの操作を経ずに呼ぶと断られるので、最初のロックはボタンを押したときに取り、タブに戻ったときに取り直します。