SerialPort: connect-Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Vollständige Kompatibilität anzeigen
Mehr erfahren

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.

Das connect-Ereignis der SerialPort-Schnittstelle wird ausgelöst, wenn sich der Port mit dem Gerät verbindet.

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

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

Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:

onconnect = (event) => { }

Genauer gesagt wird das connect-Ereignis ausgelöst, wenn der Port logisch mit dem Gerät verbunden wird. Dies geschieht, nachdem ein Benutzer einer Website nach einem Aufruf von Serial.requestPort() die Berechtigung erteilt hat, auf den Port zuzugreifen, an den das Gerät angeschlossen ist:

Bei einem kabelgebundenen seriellen Port geschieht dies, wenn der Port physisch mit dem Gerät verbunden wird, beispielsweise über USB.
Bei einem drahtlosen seriellen Port (beispielsweise Bluetooth RFCOMM) geschieht dies, wenn der Port eine oder mehrere aktive Verbindungen zum Gerät herstellt (beispielsweise über Bluetooth-L2CAP-Kanäle).

// Prompt user to choose a serial port
const port = await navigator.serial.requestPort();

port.addEventListener("connect", (event) => {
  // notify that the chosen port is connected
});

Auf neu verbundene Ports reagieren

Das connect-Ereignis wird an das Serial-Objekt weitergegeben. Dort können Sie auf die Verbindung beliebiger neuer Ports reagieren.

navigator.serial.addEventListener("connect", (event) => {
  // notify that a new port is available
  // use `event.target` to refer to the newly-added port
});