Gamepad: index property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
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.
Value
A number
.
Examples
js
window.addEventListener("gamepadconnected", () => {
const gp = navigator.getGamepads()[0];
gamepadInfo.textContent = `Gamepad connected at index ${gp.index}: ${gp.id}.`;
});
Specifications
Specification |
---|
Gamepad # dom-gamepad-index |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
index |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.