ユーザーによる有効化によって制御される機能

挙動が望むものでないとき悪いユーザー体験をもたらす API をアプリケーションに濫用させないため、ユーザーが「アクティブに操作中」の状態、すなわちユーザーが現在ウェブページを操作しているか、もしくは少なくとも 1 回ページを操作したか、のときのみ使用可能な API があります。ブラウザーは、悪意のあるスクリプトがこれらの機能を濫用するのを防ぐため、ポップアップ、フルスクリーン、振動などの機微な API へのアクセスを制限します。このページでは、ユーザーによる有効化の後にのみ利用可能になるウェブプラットフォームの機能を挙げています。

ユーザーによる有効化は、ユーザーが最近ページを操作した、またはページを読み込んでから操作を完了したことを表します。通常、これはボタンのクリックや他の UI の操作です。

より正確には、有効化を起こす入力イベント とは以下の条件を満たすイベントです。

isTrusted 属性が true に設定されており、かつ
以下の種類のイベントである
- keydown (Esc およびユーザーエージェントによって予約されているショートカットキーを除く)
- mousedown
- pointerdown (pointerType が "mouse" であるとき)
- pointerup (pointerType が "mouse" でないとき)
- touchend

有効化が起きる時、ユーザーエージェントは「粘着的」と「一時的」の 2 種類のウインドウのユーザーによる有効化状態を区別します。

一時的な有効化

一時的な有効化は､ユーザーが最近ボタンを押したか､マウスを動かしたか､メニューを使用したか､他の何らかの操作をしたことを表すウインドウの状態です｡一時的な有効化は (他の操作によって更新されなければ) タイムアウトによって無効になり、(Window.open() のような) API によって消費されることもあります。

一時的な有効化を必要とする API の例です（すべてではありません）。