HTTP-заголовок Permissions-Policy с директивой gamepad управляет тем, разрешено ли текущему документу использовать API Gamepad.

В частности, если определённая политика запрещает использование этой функции, вызовы Navigator.getGamepads() приведут к возникновению SecurityError DOMException. Кроме того, события gamepadconnected и gamepaddisconnected не будут срабатывать.

Синтаксис

Permissions-Policy: gamepad=<allowlist>;

<allowlist>

Список источников, которым разрешено использовать эту функцию. Подробнее см. в разделе Permissions-Policy > Синтаксис.

Политика по умолчанию

Список разрешённых источников по умолчанию для gamepad — *.

Примеры

Общий пример

Компания SecureCorp Inc. хочет отключить API Gamepad во всех контекстах просмотра, кроме контекстов с собственным источником и источником https://example.com. Для этого можно добавить следующий HTTP-заголовок ответа, задающий Permissions Policy:

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

С элементом <iframe>

Компания FastCorp Inc. хочет отключить gamepad во всех дочерних фреймах с другим источником, кроме определённого <iframe>. Для этого можно добавить следующий HTTP-заголовок ответа, задающий Permissions Policy:

Permissions-Policy: gamepad=(self)

Затем добавьте атрибут allow к элементу <iframe>:

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

Атрибуты iframe позволяют выборочно включать функции в одних фреймах и отключать их в других, даже если эти фреймы содержат документы с одним и тем же источником.

Спецификации

Совместимость с браузерами

См. также

• Заголовок Permissions-Policy
• Permissions Policy