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 des Ports zum Gerät getrennt wird.

Beschreibung

Genauer gesagt tritt das disconnect-Ereignis auf, wenn ein Port, der zuvor logisch verbunden war, nachdem einem Benutzer das Recht eingeräumt wurde, dass eine Website darauf zugreifen darf (nach einem Aufruf von Serial.requestPort()), nicht mehr verbunden ist.

Bubbling

Dieses Ereignis blubbert bis zur Instanz von Serial, die diese Schnittstelle zurückgegeben hat. Die Eigenschaft event.target verweist auf das SerialPort-Objekt, das nach oben blubbert.

Für weitere Informationen siehe Ereignis-Bubbling.

Syntax

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

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

ondisconnect = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Benachrichtigung, wenn ein bestimmter Port die Verbindung verliert

Hier wird der Event Listener auf einem bestimmten SerialPort-Objekt installiert.

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

Hören auf alle Ports, die nicht mehr verfügbar sind

Das disconnect-Ereignis blubbert bis zum Serial-Objekt, wo Sie auf alle nicht mehr verfügbaren Ports hören können.

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

Spezifikationen

Spezifikation
Web Serial API
# dfn-disconnect
Web Serial API
# dom-serialport-ondisconnect

Browser-Kompatibilität

Siehe auch