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
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
index | Chrome
Full support
35
| Edge Full support 12 | Firefox
Full support
29
| IE No support No | Opera
Full support
22
| Safari Full support 10.1 | WebView Android No support No | Chrome Android
Full support
35
| Firefox Android Full support 32 | Opera Android
Full support
22
| Safari iOS Full support 10.3 | Samsung Internet Android
Full support
4.0
|
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- User must explicitly enable this feature.
- User must explicitly enable this feature.
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.