Permissions-Policy: gamepad

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

Der HTTP-Header Permissions-Policy mit der Direktive gamepad steuert, ob das aktuelle Dokument die Nutzung der Gamepad API erlaubt.

Insbesondere wird bei einer definierten Richtlinie, die die Nutzung dieses Features blockiert, ein SecurityError DOMException bei Aufrufen von Navigator.getGamepads() ausgelöst. 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 Erlaubnis zur Nutzung des Features erteilt wird. Weitere Details finden Sie unter Permissions-Policy > Syntax.

Standardrichtlinie

Die Standard-allowlist 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 diejenigen mit dem Ursprung https://example.com. Dies kann durch das Senden des folgenden HTTP-Antwort-Headers zur Definition einer Berechtigungsrichtlinie erreicht werden:

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

Mit einem <iframe>-Element

FastCorp Inc. möchte gamepad für alle Cross-Origin-Kindrahmen deaktivieren, außer für ein bestimmtes <iframe>. Dies kann durch das Senden des folgenden HTTP-Antwort-Headers zur Definition einer Berechtigungsrichtlinie erreicht werden:

http
Permissions-Policy: gamepad=(self)

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

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

Iframe-Attribute können Funktionen selektiv in bestimmten Rahmen aktivieren und in anderen nicht, selbst wenn diese Rahmen Dokumente desselben Ursprungs 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