The GamepadEvent interface of the Gamepad API contains references to gamepads connected to the system, which is what the gamepad events Window.gamepadconnected
and Window.gamepaddisconnected
are fired in response to.
Properties
GamepadEvent.gamepad
Read only- Returns a
Gamepad
object, providing access to the associated gamepad data for the event fired.
Examples
The gamepad property being called on a fired Window.gamepadconnected
event.
window.addEventListener("gamepadconnected", function(e) { console.log("Gamepad connected at index %d: %s. %d buttons, %d axes.", e.gamepad.index, e.gamepad.id, e.gamepad.buttons.length, e.gamepad.axes.length); });
And on a Window.gamepaddisconnected
event.
window.addEventListener("gamepaddisconnected", function(e) { console.log("Gamepad disconnected from index %d: %s", e.gamepad.index, e.gamepad.id); });
Specifications
Specification | Status | Comment |
---|---|---|
Gamepad The definition of 'GamepadEvent' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 35 21 — 34 webkit | Yes | 29 24 — 281 | No | 22 15 — 21 webkit | No |
gamepad | 35 21 — 34 webkit | Yes | 29 24 — 281 | No | 22 15 — 21 webkit | No |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | No | Yes | Yes | 32 | No | No | No |
gamepad | No | Yes | Yes | 32 | No | No | No |
1. From version 24 until version 28 (exclusive): this feature is behind the dom.gamepad.enabled
preference (needs to be set to true
). To change preferences in Firefox, visit about:config.