This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

gamepad

Summary

Provides access to the associated gamepad data for this event.

Property of apis/gamepad/GamepadEventapis/gamepad/GamepadEvent

Syntax

Note: This property is read-only.

var result = object.gamepad;

Return Value

Returns an object of type

Gamepad

Examples

The Gamepad API provides a function, Navigator.getGamepads, that returns a list of all devices currently visible to the web page, as an array of Gamepad objects. When a gamepad is connected, this example reports its index, id, number of buttons, number of axes, and when the gamepad data was updated.

window.addEventListener("gamepadconnected", function(e) {
  var gp = navigator.getGamepads()[e.gamepad.index];
  console.log("Gamepad connected.");
  console.log("Gamepad index:", gp.index);
  console.log("Gamepad id:", gp.id);
  console.log("Gamepad buttons:", gp.buttons.length);
  console.log("Gamepad axes:", gp.axes.length);
  console.log("Gamepad last updated:", gp.timestamp);
});

Related specifications

W3C Gamepad Specification
W3C Working Draft

Attributions

  • Mozilla Developer Network cc-by-sa-small-wpd.svg: Article