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

Navigator.getGamepads()

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2017.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La méthode Navigator.getGamepads() renvoie un tableau d'objets Gamepad, un par contrôleur connecté à la machine.

Des éléments dans le tableau peuvent être null si un contrôleur est déconnecté durant la session, ainsi les autres restants gardent le même indice.

Syntaxe

js
var arrayGP = navigator.getGamepads();

Exemple

js
window.addEventListener("gamepadconnected", function (e) {
  var gp = navigator.getGamepads()[0];
  console.log(
    "Contrôleur n°%d connecté : %s. %d boutons, %d axes.",
    gp.index,
    gp.id,
    gp.buttons.length,
    gp.axes.length,
  );
});

Spécifications

Spécification
Gamepad
# dom-navigator-getgamepads

Compatibilité des navigateurs

Voir aussi