HID: connect イベント

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

HID インターフェイスの connect イベントは、ユーザーエージェントが HID デバイスに接続した時発火します。

構文

イベント名を addEventListener() のようなメソッドで使うか、イベントハンドラープロパティを設定します。

js
addEventListener("connect", (event) => {});

onconnect = (event) => {};

イベント型

HIDConnectionEvent です。 Event を継承しています。

Event HIDConnectionEvent

イベントプロパティ

以下のプロパティに加え、親の Event インターフェイスから継承したプロパティが使用可能です。

device 読取専用

イベントが発火した原因の HIDDevice です。

この例では、デバイスの接続を監視するためにイベントリスナーを登録します。接続時、デバイス名が HIDDevice.productName を用いてコンソールに出力されます。

js
navigator.hid.addEventListener("connect", ({ device }) => {
  console.log(`HID connected: ${device.productName}`);
});

仕様書

Specification
WebHID API
# dom-hid-onconnect

ブラウザーの互換性

BCD tables only load in the browser