Permissions-Policy: gamepad

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die HTTP-Direktive Permissions-Policy gamepad steuert, ob das aktuelle Dokument die Gamepad API verwenden darf.

Insbesondere, wenn eine definierte Richtlinie die Nutzung dieser Funktion blockiert, werden Aufrufe an Navigator.getGamepads() einen SecurityError DOMException auslösen. Zusätzlich werden die Ereignisse gamepadconnected und gamepaddisconnected nicht ausgelöst.

Syntax

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

Eine Liste von Ursprüngen, für die die Berechtigung zur Nutzung der Funktion erteilt wird. Siehe Permissions-Policy > Syntax für weitere Details.

Standardrichtlinie

Die Standardliste für gamepad ist self.

Beispiele

Allgemeines Beispiel

SecureCorp Inc. möchte die Gamepad API in allen Browserkontexten deaktivieren, außer für den eigenen Ursprung und für die, deren Ursprung https://example.com ist. Dies kann durch das Liefern des folgenden HTTP-Antwort-Headers erreicht werden, um eine Berechtigungsrichtlinie zu definieren:

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

Mit einem <iframe>-Element

FastCorp Inc. möchte gamepad für alle cross-origin Kinder-Frames deaktivieren, mit Ausnahme eines bestimmten <iframe>. Dies kann durch das Liefern des folgenden HTTP-Antwort-Headers erreicht werden, um eine Berechtigungsrichtlinie zu definieren:

http
Permissions-Policy: gamepad=(self)

Dann fügen Sie ein allow Attribut im <iframe>-Element hinzu:

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

Iframe-Attribute können Funktionen in bestimmten Frames selektiv aktivieren und in anderen nicht, selbst wenn diese Frames Dokumente vom gleichen Ursprung enthalten.

Spezifikationen

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.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch