HID: disconnect イベント

Limited availability

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

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

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

HID インターフェイスの disconnect イベントは、ユーザーエージェントが HID デバイスを切断した時発火します。

構文

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

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

ondisconnect = (event) => {};

イベント型

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

Event HIDConnectionEvent

イベントプロパティ

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

device 読取専用

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

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

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

仕様書

Specification
WebHID API
# dom-hid-ondisconnect

ブラウザーの互換性

BCD tables only load in the browser