Der HTTP-HeaderPermissions-Policy mit dergamepad-Direktive steuert, ob das aktuelle Dokument dieGamepad API verwenden darf.

Insbesondere, wenn eine definierte Richtlinie die Nutzung dieses Features blockiert, werden Aufrufe vonNavigator.getGamepads() einenSecurityErrorDOMException auslösen. Darüber hinaus werden die Ereignissegamepadconnected undgamepaddisconnected 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 unterPermissions-Policy > Syntax.

Standardrichtlinie

Die Standard-Whitelist fürgamepad ist*.

Beispiele

Allgemeines Beispiel

SecureCorp Inc. möchte die Gamepad API in allen Browsing-Kontexten deaktivieren, außer für ihren eigenen Ursprung und solche, deren Ursprunghttps://example.com ist.Dies kann durch Auslieferung des folgenden HTTP-Response-Headers zur Definition einer Permissions Policy erreicht werden:

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

Mit einem<iframe>-Element

FastCorp Inc. möchtegamepad für alle fremden Kindrahmen deaktivieren, außer für ein bestimmtes<iframe>.Dies kann durch Auslieferung des folgenden HTTP-Response-Headers zur Definition einer Permissions Policy erreicht werden:

Permissions-Policy: gamepad=(self)

Fügen Sie dann einallow-Attribut zum<iframe>-Element hinzu:

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

iframe-Attribute können Features in bestimmten Frames selektiv aktivieren und in anderen nicht, selbst wenn diese Frames Dokumente mit demselben Ursprung enthalten.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Permissions-Policy-Header
• Permissions Policy