SerialPort: connect イベント

Limited availability

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

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

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

SerialPort インターフェイスの connect イベントは、ポートがデバイスに接続された時、発火します。このイベントは、USB で接続されたデバイスなどの取り外し可能なデバイスに関連付いたポートに関してのみ発火します。

このイベントは、このインターフェイスを返した Serial のインスタンスに伝搬します。

構文

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

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

onconnect = (event) => {};

汎用の Event です。

このイベントは Serial に伝搬します。event.target プロパティはイベントを発生させた SerialPort オブジェクトを指します。

Serial.requestPort() メソッドは、ユーザーが選択した SerialPort で解決する Promise を返します。

// ユーザーにシリアルポートを選んでもらう
const port = await navigator.serial.requestPort();

port.addEventListener("connect", (event) => {
  // 選択されたポートが接続されたら通知する
});

connect イベントは Serial オブジェクトに伝搬し、ここで新しく接続された任意のポートを監視することができます。

navigator.serial.addEventListener("connect", (event) => {
  // 新しいポートが利用可能になったら通知する
  // 新しいポートを参照するには、`event.target` を使う
});

Specification
Web Serial API # dfn-connect
Web Serial API # dom-serialport-onconnect

This page was last modified on ⁨2025年3月21日⁩ by MDN contributors.