SerialPort: connect-Event
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.
Der connect
-Event des SerialPort
-Interfaces wird ausgelöst, wenn der Port mit dem Gerät verbunden wird.
Beschreibung
Genauer gesagt wird der connect
-Event ausgelöst, wenn der Port nach der Gewährung der Benutzerberechtigung für eine Website, den Port nach einem Aufruf von Serial.requestPort()
zuzugreifen, logisch verbunden ist:
- Bei einem kabelgebundenen seriellen Port erfolgt dies, wenn der Port physisch mit dem Gerät verbunden ist, zum Beispiel über USB.
- Bei einem drahtlosen seriellen Port (zum Beispiel Bluetooth RFCOMM) erfolgt dies, wenn der Port eine oder mehrere aktive Verbindungen zum Gerät herstellt (zum Beispiel über Bluetooth L2CAP-Kanäle).
Bubbling
Dieser Event propagiert sich zur Instanz von Serial
, die dieses Interface zurückgegeben hat. Die Eigenschaft event.target
bezieht sich auf das SerialPort
-Objekt, das nach oben propagiert.
Für weitere Informationen siehe Event-Bubbling.
Syntax
Verwenden Sie den Event-Namen in Methoden wie addEventListener()
oder setzen Sie eine Event-Handler-Eigenschaft.
addEventListener("connect", (event) => { })
onconnect = (event) => { }
Event-Typ
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 neu verbundene Ports
Der connect
-Event propagiert sich zum Serial
-Objekt, bei dem 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
Siehe auch
disconnect
-Event