The Gamepad.id property of the Gamepad interface returns a string containing some information about the controller.
The exact syntax is not strictly specified, but in Firefox it will contain three pieces of information separated by dashes (-):
- Two 4-digit hexadecimal strings containing the USB vendor and product id of the controller
- The name of the controller as provided by the driver.
For example, a PS2 controller returned 810-3-USB Gamepad.
This information is intended to allow you to find a mapping for the controls on the device as well as display useful feedback to the user.
Syntax
readonly attribute DOMString id;
Example
window.addEventListener("gamepadconnected", function() {
var gp = navigator.getGamepads()[0];
gamepadInfo.innerHTML = "Gamepad connected at index " + gp.index + ": " + gp.id + ".";
});
Value
A string.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Gamepad The definition of 'Gamepad.id' in that specification. |
Working Draft | Initial definition |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| General support | 21.0 webkit 35.0 |
(Yes) | 29.0 (29.0) | No support | 15.0 webkit 22.0 |
No support |
| Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| General support | No support | (Yes) | 32.0 (32.0) | No support | No support | No support |