Navigator.getGamepads()
This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.
The Navigator.getGamepads()
method returns an array: the first value is null
, and the others are all Gamepad
objects, one for each gamepad connected to the device. So if no gamepads are connected, the method will just return null
.
Syntax
var arrayGP = navigator.getGamepads();
Example
window.addEventListener("gamepadconnected", function(e) { var gp = navigator.getGamepads()[0]; console.log("Gamepad connected at index %d: %s. %d buttons, %d axes.", gp.index, gp.id, gp.buttons.length, gp.axes.length); });
Specifications
Specification | Status | Comment |
---|---|---|
Gamepad The definition of 'The Gamepad API specification' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
General support |
21.0 webkit |
29.0 (29.0) [1] | Not supported |
15.0 webkit |
Not supported |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
General support | Not supported | Not supported | Not supported | Not supported | Not supported |
[1] Was available behind a preference since Firefox 24.
See also
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/navigator/getgamepads