Permissions-Policy: gamepad
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
HTTP の Permissions-Policy
ヘッダーにおける gamepad
ディレクティブは、現在の文書がゲームパッド API を使用できるかどうかを制御します。
具体的には、定義されたポリシーでこの機能の使用がブロックされた場合、 Navigator.getGamepads()
を呼び出すと SecurityError
の DOMException
が発生します。さらに、 gamepadconnected
および gamepaddisconnected
イベントは発生しません。
構文
Permissions-Policy: gamepad=<allowlist>;
<allowlist>
-
この機能を許可するオリジンのリストです。
Permissions-Policy
> 構文を参照してください。
既定のポリシー
gamepad
の既定の許可リストは self
です。
例
一般的な例
SecureCorp Inc. は、自社のオリジンおよびオリジンが https://example.com
であるものを除く、すべての閲覧コンテキストでゲームパッド API を無効にしたいと考えています。
これは、次の HTTP レスポンスヘッダーを送信して、権限ポリシーを定義することで実現できます。
Permissions-Policy: gamepad=(self "https://example.com")
<iframe> 要素の使用
cFastCorp Inc. は、 gamepad
を、特定の <iframe>
を除き、オリジン同士の子フレームすべてに対して無効にしたいと考えています。
これは、次の HTTP レスポンスヘッダーを配信して、権限ポリシーを定義することで実現できます。
Permissions-Policy: gamepad=(self)
次に、 allow 属性を <iframe>
要素に記載します。
<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.
ブラウザーの互換性
関連情報
Permissions-Policy
ヘッダー- 権限ポリシー