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: disconnect-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 disconnect-Ereignis der SerialPort-Schnittstelle wird ausgelöst, wenn die Verbindung zwischen dem Port und dem Gerät getrennt wird.

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

js
addEventListener("disconnect", (event) => { })

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

js
ondisconnect = (event) => { }

Ereignistyp

Ein generisches Event.

Beschreibung

Das disconnect-Ereignis wird ausgelöst, wenn ein Port, der zuvor logisch mit dem Gerät verbunden war, nicht mehr verbunden ist.

Bubbling

Dieses Ereignis wird an die Serial-Instanz weitergegeben, die diese Schnittstelle zurückgegeben hat. Die Eigenschaft event.target verweist auf das SerialPort-Objekt, von dem das Ereignis weitergegeben wird.

Weitere Informationen finden Sie unter Event-Bubbling.

Beispiele

Benachrichtigung, wenn die Verbindung zu einem bestimmten Port getrennt wird

Hier wird der Event-Listener für ein bestimmtes SerialPort-Objekt registriert.

js
port.addEventListener("disconnect", (event) => {
  // notify that the port has become unavailable
});

Erkennen, wenn ein beliebiger Port nicht mehr verfügbar ist

Das disconnect-Ereignis wird an das Serial-Objekt weitergegeben. Dort können Sie erkennen, wenn ein beliebiger Port nicht mehr verfügbar ist.

js
navigator.serial.addEventListener("disconnect", (event) => {
  // notify that a port has become unavailable
  // use `event.target` to refer to the unavailable port
});

Spezifikationen

Spezifikation
WebSerial
# dfn-disconnect
WebSerial
# dom-serialport-ondisconnect

Browser-Kompatibilität

Siehe auch