SerialPort: connect-Ereignis
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
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.
Beschreibung
Genauer gesagt wird das connect
-Ereignis ausgelöst, wenn der Port logisch verbunden mit dem Gerät wird, nachdem ein 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 zum Gerät herstellt (zum Beispiel über Bluetooth L2CAP-Kanäle).
Bubbling
Dieses Ereignis steigt bis zur Instanz von Serial
auf, die dieses Interface zurückgab. Die Eigenschaft event.target
bezieht sich auf das SerialPort
-Objekt, das sich aufbläht.
Für weitere Informationen siehe Ereignis-Bubbling.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("connect", (event) => {});
onconnect = (event) => {};
Ereignistyp
Ein generisches Event
.
Beispiele
Benachrichtigung, wenn ein bestimmter Port verbunden wird
Die Methode Serial.requestPort()
gibt ein Promise
zurück, das mit einem vom Benutzer ausgewä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
});
Lauschen auf alle neu verbundenen Ports
Das connect
-Ereignis steigt bis zum Serial
-Objekt auf, 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
});
Spezifikationen
Specification |
---|
Web Serial API # dfn-connect |
Web Serial API # dom-serialport-onconnect |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
disconnect
-Ereignis