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.
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.
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.
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
connectEreignis