The GamepadEvent.gamepad property of the GamepadEvent interface returns a Gamepad object, providing access to the associated gamepad data for fired gamepadconnected and gamepaddisconnected events.
Note: These events are not fired in Chrome, only Firefox. In Chrome you have to use Navigator.getGamepads to access Gamepad objects.
Syntax
readonly attribute Gamepad gamepad;
Example
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);
});
Value
A Gamepad object.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Gamepad The definition of 'GamepadEvent.gamepad' 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 |
| Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| Basic Support | 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.