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

Specification
Gamepad
# event-gamepadconnected

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
gamepadconnected event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

See also