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 Widely available *

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⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

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

Specification
Gamepad
# dom-navigator-getgamepads

Compatibilité des navigateurs

Voir aussi