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 vor der Verwendung auf produktiven Webseiten.

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

Das connect-Ereignis des SerialPort-Interfaces wird ausgelöst, wenn der Port mit dem Gerät verbunden wird.

Beschreibung

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

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

Bubbling

Dieses Ereignis steigt bis zur Instanz von Serial auf, die dieses Interface zurückgab. Die Eigenschaft event.target bezieht sich auf das SerialPort-Objekt, das sich aufbläht.

Für weitere Informationen siehe Ereignis-Bubbling.

Syntax

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

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

onconnect = (event) => {};

Ereignistyp

Ein generisches Event.

Beispiele

Benachrichtigung, wenn ein bestimmter Port verbunden wird

Die Methode Serial.requestPort() gibt ein Promise zurück, das 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 alle neu verbundenen Ports

Das connect-Ereignis steigt bis zum Serial-Objekt auf, wo Sie auf alle neu verbundenen Ports 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