Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Window : évènement gamepadconnected

Baseline 2025
Newly available

Depuis December 2025, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

L'évènement gamepadconnected de l'interface Window est déclenché lorsque le navigateur détecte qu'une manette a été connectée ou la première fois qu'un bouton ou un axe de la manette est utilisé.

L'évènement ne se déclenche pas si le document l'interdit par la politique d'autorisations gamepad.

Cet évènement n'est pas annulable et ne se propage pas.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.

js
addEventListener("gamepadconnected", (event) => { })

ongamepadconnected = (event) => { }

Exemples

Pour être informé lorsqu'une manette est connectée, vous pouvez ajouter un gestionnaire à la fenêtre en utilisant addEventListener(), comme ceci :

js
window.addEventListener("gamepadconnected", (event) => {
  // Toutes les valeurs des boutons et des axes peuvent être accessibles avec
  const gamepad = event.gamepad;
});

D'autre part, vous pouvez utiliser la propriété de gestionnaire d'évènement window.ongamepadconnected pour établir un gestionnaire pour l'évènement gamepadconnected :

js
window.ongamepadconnected = (event) => {
  // Toutes les valeurs des boutons et des axes peuvent être accessibles avec
  const gamepad = event.gamepad;
};

Spécifications

Specification
Gamepad
# event-gamepadconnected

Compatibilité des navigateurs

Voir aussi