The Gamepad.index property of the Gamepad interface returns an integer that is auto-incremented to be unique for each device currently connected to the system.
This can be used to distinguish multiple controllers; a gamepad that is disconnected and reconnected will retain the same index.
Syntax
readonly attribute long index;
Example
window.addEventListener("gamepadconnected", function() {
var gp = navigator.getGamepads()[0];
gamepadInfo.innerHTML = "Gamepad connected at index " + gp.index + ": " + gp.id + ".";
});
Value
A number.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Gamepad The definition of 'Gamepad.index' in that specification. |
Working Draft | Initial definition |
Browser compatibility
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 35 21 — 34 webkit | 12 | 29 24 — 281 | No | 22 15 — 21 webkit | No |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | No | 35 21 — 34 webkit | Yes | 32 | No | No | Yes |
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.
See also
Document Tags and Contributors
Tags:
Contributors to this page:
connorshea,
eof273,
fscholz,
erikadoyle,
Sebastianz,
teoli,
chrisdavidmills
Last updated by:
connorshea,