Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 ⁨März 2017⁩.

* Some parts of this feature may have varying levels of support.

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

Elemente im Array können null sein, wenn ein Gamepad während einer Sitzung getrennt wird, damit die verbleibenden Gamepads den gleichen 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 Berechtigungsrichtlinie 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

Siehe auch