MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/d6d7ff2e2f9c

Gamepad.hand

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The hand read-only property of the Gamepad interface returns an enum defining what hand the controller is being held in, or is most likely to be held in.

Syntax

var myHand = gamepadInstance.hand;

Value

A GamepadHand enum; possible values are:

  • left — the left hand.
  • right — the right hand.
  • Empty string ("") — this value is returned if the other values are not applicable, e.g. the controller is held in both hands, or would be fine in either.

Examples

TBC

Specifications

Specification Status Comment
Gamepad Extensions
The definition of 'hand' in that specification.
Editor's Draft Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic Support No Notrue1 2 No No No
FeatureAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic Support No No No No No No No

1. The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above.

2. From version true, this feature is behind the dom.gamepad-extensions.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

See also

Document Tags and Contributors

 Contributors to this page: fscholz, chrisdavidmills
 Last updated by: fscholz,