SerialPort: connect Ereignis

Limited availability

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

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Hinweis: Dieses Feature ist verfügbar in Dedicated Web Workers.

Das connect-Ereignis des SerialPort-Interfaces wird ausgelöst, wenn der Anschluss eine Verbindung mit dem Gerät herstellt.

Beschreibung

Genauer gesagt wird das connect-Ereignis ausgelöst, wenn der Anschluss nach der Gewährung der Berechtigung durch den Benutzer für eine Website, Zugriff auf den Anschluss zu erhalten, logisch mit dem Gerät verbunden wird, nach einem Aufruf von Serial.requestPort():

  • Bei einem kabelgebundenen seriellen Anschluss tritt dies ein, wenn der Anschluss physisch mit dem Gerät verbunden ist, z. B. über USB.
  • Bei einem drahtlosen seriellen Anschluss (z. B. Bluetooth RFCOMM) tritt dies ein, wenn der Anschluss eine oder mehrere aktive Verbindungen mit dem Gerät herstellt (z. B. über Bluetooth L2CAP-Kanäle).

Bubbling

Dieses Ereignis verbreitet sich bis zur Instanz von Serial, die dieses Interface zurückgegeben hat. Die Eigenschaft event.target bezieht sich auf das SerialPort-Objekt, das weitergegeben wird.

Für weitere Informationen siehe Event-Bubbling.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

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

onconnect = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

Benachrichtigung, wenn ein bestimmter Anschluss verbunden wird

Die Methode Serial.requestPort() gibt einen Promise zurück, der mit einem vom Benutzer ausgewählten SerialPort aufgelöst wird.

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

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

Lauschen auf neu verbundene Anschlüsse

Das connect-Ereignis verbreitet sich bis zum Serial-Objekt, wo Sie auf neu verbundene Anschlüsse lauschen können.

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch