Permissions-Policy: gamepad

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

HTTP の Permissions-Policy ヘッダーにおける gamepad ディレクティブは、現在の文書がゲームパッド API を使用できるかどうかを制御します。

具体的には、定義されたポリシーでこの機能の使用がブロックされた場合、 Navigator.getGamepads() を呼び出すと SecurityErrorDOMException が発生します。さらに、 gamepadconnected および gamepaddisconnected イベントは発生しません。

構文

http
Permissions-Policy: gamepad=<allowlist>;
<allowlist>

この機能を許可するオリジンのリストです。 Permissions-Policy > 構文を参照してください。

既定のポリシー

gamepad の既定の許可リストは self です。

一般的な例

SecureCorp Inc. は、自社のオリジンおよびオリジンが https://example.com であるものを除く、すべての閲覧コンテキストでゲームパッド API を無効にしたいと考えています。 これは、次の HTTP レスポンスヘッダーを送信して、権限ポリシーを定義することで実現できます。

http
Permissions-Policy: gamepad=(self "https://example.com")

<iframe> 要素の使用

cFastCorp Inc. は、 gamepad を、特定の <iframe> を除き、オリジン同士の子フレームすべてに対して無効にしたいと考えています。 これは、次の HTTP レスポンスヘッダーを配信して、権限ポリシーを定義することで実現できます。

http
Permissions-Policy: gamepad=(self)

次に、 allow 属性を <iframe> 要素に記載します。

html
<iframe src="https://other.com/game" allow="gamepad"></iframe>

iframe 属性は、特定のフレームで機能を選択的に有効にすることができ、同じオリジンからの文書を含むフレームでも、他のフレームでは機能しないようにすることができます。

仕様書

No specification found

No specification data found for http.headers.Permissions-Policy.gamepad.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

ブラウザーの互換性

関連情報