Gamepad.mapping

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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support

35

21 — 34 webkit

Yes

29

24 — 281

No

22

15 — 21 webkit

No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic support No Yes Yes32 No No No

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

Using the Gamepad API

Document Tags and Contributors

 Contributors to this page: fscholz, erikadoyle, Sebastianz, teoli, chrisdavidmills
 Last updated by: fscholz,