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 webview | 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.