W3cubDocs

/Web APIs

Window: gamepadconnected event

The gamepadconnected event is fired when the browser detects that a gamepad has been connected or the first time a button/axis of the gamepad is used.

The event will not fire if disallowed by the document's gamepad Permissions Policy.

This event is not cancelable and does not bubble.

Examples

To be informed when a gamepad is connected, you can add a handler to the window using addEventListener(), like this:

js

window.addEventListener("gamepadconnected", (event) => {
  // All buttons and axes values can be accessed through
  const gamepad = event.gamepad;
});

Alternatively, you can use the window.ongamepadconnected event handler property to establish a handler for the gamepadconnected event:

js

window.ongamepadconnected = (event) => {
  // All buttons and axes values can be accessed through
  const gamepad = event.gamepad;
};

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
gamepadconnected_event
35The ongamepadconnected event handler property is not supported. See bug 1192878.
≤18The ongamepadconnected event handler property is not supported. See bug 1192878.
89
29–89The ongamepadconnected event handler property is not supported. See bug 1697093.
No
22The ongamepadconnected event handler property is not supported. See bug 1192878.
10.1The ongamepadconnected event handler property is not supported. See bug 223860.
37The ongamepadconnected event handler property is not supported. See bug 1192878.
37The ongamepadconnected event handler property is not supported. See bug 1192878.
89
32–89The ongamepadconnected event handler property is not supported. See bug 1697093.
24The ongamepadconnected event handler property is not supported. See bug 1192878.
No
3.0The ongamepadconnected event handler property is not supported. See bug 1192878.

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Window/gamepadconnected_event