Navigator: getGamepads() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Navigator.getGamepads() メソッドは Gamepad の配列を返します。それぞれがこの端末に接続されているゲームパッドを表します。

セッション中にゲームパッドが切断された場合、配列の要素は null になる可能性がありますので、残りのゲームパッドは同じインデックスを保持します。

構文

js
getGamepads()

引数

なし。

返値

Gamepad の配列 (Array) で、空になることもあります。

例外

SecurityError DOMException

権限ポリシーによって、この機能の使用がブロックされた場合。

例

js
window.addEventListener("gamepadconnected", (e) => {
  const gp = navigator.getGamepads()[e.gamepad.index];
  console.log(
    `Gamepad connected at index ${gp.index}: ${gp.id} with ${gp.buttons.length} buttons, ${gp.axes.length} axes.`,
  );
});

仕様書

Specification
Gamepad
# dom-navigator-getgamepads

ブラウザーの互換性

BCD tables only load in the browser

関連情報