Limited support 一部のブラウザのみ対応。使用時はサポート状況を確認すること。

Idle detection

セキュアコンテキスト: この機能は、一部またはすべての対応ブラウザーにおいて、セキュアコンテキスト (HTTPS) でのみ利用可能です。

試験的: これは試験的な技術です。

本番環境で使用する前に、ブラウザーの互換性一覧表を注意深く確認してください。

注: この機能は Dedicated Web Workers で利用可能です。

Idle Detection API の `IdleDetector` インターフェイスは、デバイスまたは画面上でのユーザーアクティビティを検出するためのメソッドとイベントを提供します。

このインターフェイスはセキュアコンテキストを必要とします。

EventTarget

IdleDetector

埋め込み

対応ブラウザ

機能	デスクトップ				モバイル
機能	Chrome	Edge	Firefox	Safari	Chrome Android	Safari iOS
`IdleDetector` 実験的	94	114			94
`change_event` 実験的 IdleDetector インターフェイスの変更イベントは、userState または screenState の値が変更されたときに発生します。	94	114			94
`IdleDetector` 実験的 IdleDetector() コンストラクターは、ユーザーがデバイスを操作しなくなったとき、または画面がロックされたときを示すイベントを提供する新しい IdleDetector オブジェクトを作成します。	94	114			94
`requestPermission_static` 実験的 IdleDetector インターフェイスの requestPermission() 静的メソッドは、ユーザーがオリジンにアイドル状態へのアクセスを許可するかどうかを選択したときに、文字列で解決される Promise を返します。受け入れの場合は「許可」、拒否の場合は「拒否」で解決します。	94	114			94
`screenState` 実験的 IdleDetector インターフェイスの screenState 読み取り専用プロパティは、画面がロックされているかどうか (「ロック」または「ロック解除」のいずれか) を示す文字列を返します。	94	114			94
`start` 実験的 IdleDetector インターフェイスの start() メソッドは、検出器がユーザーのアイドル状態の変化の監視を開始したときに解決される Promise を返します。このメソッドは、非アクティブ状態が報告されるミリ秒単位のしきい値を含むオプションのオプションオブジェクトを受け取り、アイドル検出器を中止するための AbortSignal の信号を受け取ります。	94	114			94
`userState` 実験的 IdleDetector インターフェイスの userState 読み取り専用プロパティは、start() の呼び出し以降にユーザーがデバイスと対話したかどうかを示す文字列を返します。	94	114			94
その他
`html.elements.iframe.allow.idle-detection` 実験的	94	94			94
`http.headers.Permissions-Policy.idle-detection` 実験的 HTTP の Permissions-Policy ヘッダーの idle-detection ディレクティブは、現在の文書がIdle Detection API を使用して、ユーザーが端末を操作しているかどうかを検出することを許可するかどうかを制御します。例えば、チャットアプリケーションで「利用可能」/「離席中」のステータスを報告する場合などです。	94	94			94

1+対応 (バージョン) 未対応 ※注釈ありサブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT

const detector = new IdleDetector();
detector.addEventListener('change', () => {
  console.log('User:', detector.userState);  // 'active' | 'idle'
  console.log('Screen:', detector.screenState);   // 'locked' | 'unlocked'
});
await detector.start({ threshold: 60000 });

実務での使いどころ

Idle detection の活用

セキュアコンテキスト: この機能は、一部またはすべての対応ブラウザーにおいて、セキュアコンテキスト (HTTPS) でのみ利用可能です。

注意点

一部のブラウザでのみ対応。使用前にブラウザサポートを確認すること。

対応ブラウザ

基本構文

実務での使いどころ

Idle detection の活用

注意点

アクセシビリティ

参考リンク