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.
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.
// 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.
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
disconnect-Ereignis