Permissions-Policy: gamepad
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
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
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:
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:
Permissions-Policy: gamepad=(self)
Dann fügen Sie ein allow-Attribut zum <iframe>
-Element hinzu:
<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