导航器：getGamepads() 方法

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，在一些或所有支持的浏览器中可用。

Navigator.getGamepads() 方法返回一个 Gamepad 对象的数组，每个连接到设备的游戏手柄对应一个对象。

如果在会话期间游戏手柄断开连接，则数组中的元素可能为 null，以便剩余的游戏手柄保留相同的索引。

语法

js
getGamepads()

参数

无。

返回值

一个 Array，其中包含 Gamepad 对象，最终可能为空。

异常

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.`,
  );
});

规范

规范
游戏手柄
# dom-navigator-getgamepads

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅