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, bevor Sie diese produktiv verwenden.
Hinweis: Dieses Feature ist verfügbar in Dedicated Web Workers.
Das connect
-Ereignis des SerialPort
-Interfaces wird ausgelöst, wenn der Anschluss eine Verbindung mit dem Gerät herstellt.
Beschreibung
Genauer gesagt wird das connect
-Ereignis ausgelöst, wenn der Anschluss nach der Gewährung der Berechtigung durch den Benutzer für eine Website, Zugriff auf den Anschluss zu erhalten, logisch mit dem Gerät verbunden wird, nach einem Aufruf von Serial.requestPort()
:
- Bei einem kabelgebundenen seriellen Anschluss tritt dies ein, wenn der Anschluss physisch mit dem Gerät verbunden ist, z. B. über USB.
- Bei einem drahtlosen seriellen Anschluss (z. B. Bluetooth RFCOMM) tritt dies ein, wenn der Anschluss eine oder mehrere aktive Verbindungen mit dem Gerät herstellt (z. B. über Bluetooth L2CAP-Kanäle).
Bubbling
Dieses Ereignis verbreitet sich bis zur Instanz von Serial
, die dieses Interface zurückgegeben hat. Die Eigenschaft event.target
bezieht sich auf das SerialPort
-Objekt, das weitergegeben wird.
Für weitere Informationen siehe Event-Bubbling.
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
.
Beispiele
Benachrichtigung, wenn ein bestimmter Anschluss verbunden wird
Die Methode Serial.requestPort()
gibt einen Promise
zurück, der 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 Anschlüsse
Das connect
-Ereignis verbreitet sich bis zum Serial
-Objekt, wo Sie auf neu verbundene Anschlüsse 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