Navigator: метод getGamepads()

Базовая Широко поддерживается *

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.

* Некоторые части этой функции могут иметь различный уровень поддержки.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.

Метод Navigator.getGamepads() возвращает массив Gamepad объектов, по одному на каждое подключенное к устройству игровое устройство.

Элементы массива могут быть null в случае отключения игрового устройства во время сессии, чтобы оставшиеся игровые устройства сохранили те же индексы.

Синтаксис

getGamepads()

Параметры

Нет.

Возвращаемое значение

Массив Array объектов Gamepad, в конечном итоге пустой.

Исключения

SecurityError DOMException: Использование этой функции было заблокировано политикой Permissions Policy.

Примеры

window.addEventListener("gamepadconnected", (e) => {
  const gp = navigator.getGamepads()[e.gamepad.index];
  console.log(
    `Gamepad connected at index ${gp.index}: ${gp.id} with ${gp.buttons.length} buttons, ${gp.axes.length} axes.`,
  );
});

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

Спецификация
Gamepad # dom-navigator-getgamepads

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getGamepads`	3521	12	29	2215	10.1	3525	32	2214	10.3	3.01.5	37≤37
`secure_context_required`	86	86	91	72	Нет	86	Нет	Нет	Нет	Нет	Нет

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigator/getGamepads