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
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:
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:
Permissions-Policy: gamepad=(self)
Dann fügen Sie ein allow Attribut im <iframe>
-Element hinzu:
<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