---
title: GamepadEvent
slug: Web/API/GamepadEvent
translation_of: Web/API/GamepadEvent
---
<p>{{APIRef("Gamepad API")}}</p>

<p>Gamepad API 的 GamepadEvent 接口包含对连接到系统的控制器的引用，这也是 gamepad 事件events {{domxref("Window.gamepadconnected")}} 与 {{domxref("Window.gamepaddisconnected")}} 被触发时响应的内容。</p>

<h2 id="构造函数">构造函数</h2>

<dl>
 <dt>{{domxref("GamepadEvent.GamepadEvent","GamepadEvent()")}}</dt>
 <dd>返回一个新的 <code>GamepadEvent</code> 对象。</dd>
</dl>

<h2 id="属性">属性</h2>

<dl>
 <dt>{{ domxref("GamepadEvent.gamepad") }} {{readonlyInline}}</dt>
 <dd>返回一个 {{ domxref("Gamepad") }} 对象，提供触发事件的控制器数据的访问。</dd>
</dl>

<h2 id="示例">示例</h2>

<p>在触发的 {{domxref("Window.gamepadconnected")}} 事件上调用控制器属性。</p>

<pre class="brush: js">window.addEventListener("gamepadconnected", function(e) {
  console.log("控制器已连接于 %d 位：%s。 %d 个按键，%d 个坐标方向。",
  e.gamepad.index, e.gamepad.id,
  e.gamepad.buttons.length, e.gamepad.axes.length);
});</pre>

<p>与 {{domxref("Window.gamepaddisconnected")}} 事件上的。</p>

<pre class="brush: js">window.addEventListener("gamepaddisconnected", function(e) {
  console.log("控制器已从 %d 位断开：%s",
  e.gamepad.index, e.gamepad.id);
});</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">备注</th>
  </tr>
  <tr>
   <td>{{SpecName("Gamepad", "#gamepadevent-interface", "GamepadEvent")}}</td>
   <td>{{Spec2("Gamepad")}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2>

<p>{{Compat("api.GamepadEvent")}}</p>

<h2 id="另请参阅">另请参阅</h2>

<p><a href="/en-US/docs/Web/Guide/API/Gamepad">使用 Gamepad API</a></p>