Window: gamepadconnected-Ereignis
Baseline 2025
Neu verfügbar
Seit Dezember 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Das gamepadconnected-Ereignis wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde, oder wenn zum ersten Mal eine Taste oder Achse des Gamepads verwendet wird.
Das Ereignis wird nicht ausgelöst, wenn die gamepad-Permissions Policy des Dokuments dies untersagt.
Dieses Ereignis kann nicht abgebrochen werden und wird nicht weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("gamepadconnected", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft des Interfaces zuweisen:
ongamepadconnected = (event) => { }
Beispiele
Um benachrichtigt zu werden, wenn ein Gamepad verbunden wird, können Sie mit addEventListener() einen Handler zu window hinzufügen:
window.addEventListener("gamepadconnected", (event) => {
// All buttons and axes values can be accessed through
const gamepad = event.gamepad;
});
Alternativ können Sie über die Event-Handler-Eigenschaft window.ongamepadconnected einen Handler für das gamepadconnected-Ereignis festlegen. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über ongamepadconnected hinzugefügte Event-Listener ersetzt werden:
window.ongamepadconnected = (event) => {
// All buttons and axes values can be accessed through
const gamepad = event.gamepad;
};
Spezifikationen
| Spezifikation |
|---|
| Gamepad # event-gamepadconnected |