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

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
hand
Experimental
Chrome No support NoEdge No support 15 — 79Firefox Full support Yes
Notes Disabled
Full support Yes
Notes Disabled
Notes The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above.
Disabled This feature is behind the dom.gamepad-extensions.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android No support No

Legend

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
See implementation notes.
See implementation notes.
User must explicitly enable this feature.
User must explicitly enable this feature.

See also