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 der SerialPort-Schnittstelle 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 mit dem Gerät verbunden wird, nachdem der 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 mit dem Gerät herstellt (zum Beispiel über Bluetooth L2CAP-Kanäle).

Ereignis-Bubbling

Dieses Ereignis „bubbelt“ zur Instanz von Serial, die diese Schnittstelle zurückgegeben hat. Die event.target-Eigenschaft verweist auf das SerialPort-Objekt, das hochgebubbelt ist.

Für weitere Informationen siehe Ereignis-Bubbling.

Syntax

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

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

onconnect = (event) => { }

// 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 „bubbelt“ zum Serial-Objekt hoch, wo Sie auf alle neu verbundenen Ports lauschen können.

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