SerialPort: Methode open()
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.
Die open()-Methode der SerialPort-Schnittstelle gibt ein Promise zurück, das aufgelöst wird, wenn der Port geöffnet wird. 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, nicht null Werte, der die Baudrate angibt, mit der die serielle Kommunikation hergestellt werden soll.
bufferSizeOptional-
Eine nicht-negative ganze Zahl, die die Größe der Lese- und Schreibpuffer angibt, die eingerichtet werden sollen. Wenn nicht angegeben, ist der Standardwert 255.
dataBitsOptional-
Ein ganzzahliger Wert von 7 oder 8, der die Anzahl der Datenbits pro Frame angibt. Wenn nicht angegeben, ist der Standardwert 8.
flowControlOptional-
Der Flusskontrolltyp, entweder
"none"oder"hardware". Der Standardwert ist"none". parityOptional-
Der Paritätsmodus, entweder
"none","even"oder"odd". Der Standardwert ist"none". stopBitsOptional-
Ein ganzzahliger Wert 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
Das zurückgegebene Promise lehnt mit einer der folgenden Ausnahmen ab:
InvalidStateErrorDOMException-
Wenn
open()aufgerufen wird, während der Port bereits geöffnet ist. NetworkErrorDOMException-
Wenn der Versuch, den Port zu öffnen, fehlschlägt.
Beispiele
Bevor auf einem seriellen Port kommuniziert wird, muss er geöffnet werden. Das Öffnen des Ports ermöglicht es der Website, die erforderlichen Parameter festzulegen, die steuern, wie Daten gesendet und empfangen werden. Entwickler sollten die Dokumentation des Geräts, mit dem sie sich verbinden, auf die entsprechenden Parameter überprüfen.
await port.open({ baudRate: 9600 /* pick your baud rate */ });
Spezifikationen
| Spezifikation |
|---|
| Web Serial API # dom-serialport-open |