Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

SerialPort: connect-Ereignis

Eingeschränkt verfügbar

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

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 des SerialPort-Interfaces wird ausgelöst, wenn der Port mit dem Gerät verbunden wird.

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.

Beschreibung

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

  • Im Falle eines kabelgebundenen seriellen Ports tritt dies auf, wenn der Port physisch mit dem Gerät verbunden ist, zum Beispiel über USB.
  • Im Falle eines drahtlosen seriellen Ports (zum Beispiel Bluetooth RFCOMM) tritt dies auf, 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 Serial-Instanz auf, die dieses Interface zurückgegeben hat. Die Eigenschaft event.target bezieht sich auf das SerialPort-Objekt, das aufsteigt.

Für weitere Informationen siehe Ereignis-Bubbling.

Beispiele

Benachrichtigung, wenn ein bestimmter Port verbunden wird

Die Methode Serial.requestPort() gibt ein Promise zurück, das mit einem vom Benutzer gewä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
});

Abhören von neu verbundenen Ports

Das connect-Ereignis steigt zum Serial-Objekt auf, wo Sie nach 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

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

Browser-Kompatibilität

Siehe auch