GamepadButton: value property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The GamepadButton.value property of the GamepadButton interface returns a double value used to represent the current state of analog buttons on many modern gamepads, such as the triggers.

The values are normalized to the range 0.01.0, with 0.0 representing a button that is not pressed, and 1.0 representing a button that is fully pressed.

Examples

js
let gp = navigator.getGamepads()[0];

if (gp.buttons[0].value > 0) {
  // respond to analog button being pressed in
}

Value

A double.

Specifications

Specification
Gamepad
# dom-gamepadbutton-value

Browser compatibility

BCD tables only load in the browser

See also