Navigator: getGamepads()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

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

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

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