The Gamepad.mapping property of the Gamepad interface returns a string indicating whether the browser has remapped the controls on the device to a known layout.
Currently there is only one supported known layout–the standard gamepad. If the browser is able to map controls on the device to that layout the mapping property will be set to the string standard.
Syntax
readonly attribute DOMString mapping;
Example
var gp = navigator.getGamepads()[0]; console.log(gp.mapping);
Value
A string.
Specifications
| Specification | Status | Comment |
|---|---|---|
| Gamepad The definition of 'Gamepad.mapping' 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 | 22 15 — 21 webkit | 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.