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
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | No | No | Yes1 2 | No | No | No |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS 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
Tags:
Contributors to this page:
fscholz,
chrisdavidmills
Last updated by:
fscholz,