Gamepad.hand

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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 No Yes1 2 No No No
FeatureAndroid webviewChrome 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. 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,