Navigator: getGamepads()-Methode

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die Navigator.getGamepads()-Methode gibt ein Array von Gamepad-Objekten zurück, eines für jedes mit dem Gerät verbundene Gamepad.

Elemente im Array können null sein, wenn ein Gamepad während einer Sitzung getrennt wird, damit die verbleibenden Gamepads denselben Index beibehalten.

Syntax

js
getGamepads()

Parameter

Keine.

Rückgabewert

Ein Array von Gamepad-Objekten, eventuell leer.

Ausnahmen

SecurityError DOMException

Die Nutzung dieser Funktion wurde durch eine Permissions Policy blockiert.

Beispiele

js
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.`,
  );
});

Spezifikationen

Specification
Gamepad
# dom-navigator-getgamepads

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch