USB: connect イベント

Limited availability

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

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

USB インターフェイスの connect イベントは、ペア設定済みのデバイスが接続された時発火します。

構文

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

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

onconnect = (event) => {};

イベント型

イベントプロパティ

以下に挙げるプロパティに加え、親インターフェイス Event のプロパティも利用できます。

device 読取専用

イベントが発火した対象の USBDevice です。

USB デバイスが接続された時、UI を更新したいかもしれません。

js
navigator.usb.addEventListener("connect", (event) => {
  // event.device を UI に追加する
});

別の方法として、USB.onconnect イベントハンドラープロパティを使用して connect イベント用のハンドラーを設定できます。

js
navigator.usb.onconnect = (event) => {
  // event.device を UI に追加する
};

仕様書

Specification
WebUSB API
# connect
WebUSB API
# ref-for-dom-usb-onconnect

ブラウザーの互換性

BCD tables only load in the browser