Navigator: getGamepads()-Methode
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2017 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
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
Ausnahmen
SecurityErrorDOMException-
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
| Spezifikation |
|---|
| Gamepad # dom-navigator-getgamepads |