SerialPort: open() Methode
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.
Die open()
Methode der SerialPort
Schnittstelle gibt ein Promise
zurück, das aufgelöst wird, wenn der Port geöffnet ist. Standardmäßig wird der Port mit 8 Datenbits, 1 Stoppbit und ohne Paritätsprüfung geöffnet. Der baudRate
Parameter ist erforderlich.
Syntax
open(options)
Parameter
options
-
Ein Objekt mit einem der folgenden Werte:
baudRate
-
Ein positiver, ungleich null-Wert, der die Baudrate angibt, mit der die serielle Kommunikation aufgebaut werden soll.
bufferSize
Optional-
Ein nicht unterschriebener langer Integer, der die Größe der zu etablierenden Lese- und Schreibpuffer angibt. Wenn nicht angegeben, ist der Standardwert 255.
dataBits
Optional-
Ein Ganzzahlwert von 7 oder 8, der die Anzahl der Datenbits pro Frame angibt. Wenn nicht angegeben, ist der Standardwert 8.
flowControl
Optional-
Der Typ der Flusskontrolle, entweder
"none"
oder"hardware"
. Der Standardwert ist"none"
. parity
Optional-
Der Paritätsmodus, entweder
"none"
,"even"
oder"odd"
. Der Standardwert ist"none"
. stopBits
Optional-
Ein Ganzzahlwert von 1 oder 2, der die Anzahl der Stoppbits am Ende des Frames angibt. Wenn nicht angegeben, ist der Standardwert 1.
Rückgabewert
Ein Promise
.
Ausnahmen
InvalidStateError
DOMException
-
Wird zurückgegeben, wenn der Port bereits geöffnet ist.
NetworkError
DOMException
-
Wird zurückgegeben, wenn der Versuch, den Port zu öffnen, fehlgeschlagen ist.
Beispiele
Bevor auf einem seriellen Port kommuniziert werden kann, muss er geöffnet werden. Das Öffnen des Ports ermöglicht es der Webseite, die notwendigen Parameter festzulegen, die steuern, wie Daten gesendet und empfangen werden. Entwickler sollten die Dokumentation des Geräts überprüfen, mit dem sie sich verbinden, um die geeigneten Parameter zu bestimmen.
await port.open({ baudRate: 9600 /* pick your baud rate */ });
Spezifikationen
Specification |
---|
Web Serial API # dom-serialport-open |
Browser-Kompatibilität
BCD tables only load in the browser