SerialPort: setSignals()-Methode
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 setSignals()-Methode des SerialPort-Interfaces setzt Steuersignale am Port und gibt ein Promise zurück, das aufgelöst wird, wenn sie gesetzt sind.
Syntax
setSignals()
setSignals(options)
Parameter
optionsOptional-
Ein Objekt mit einem der folgenden Werte:
dataTerminalReady-
Ein Boolean, der angibt, ob das Betriebssystem angewiesen werden soll, das "data terminal ready"- oder "DTR"-Signal am seriellen Port entweder zu aktivieren (wenn true) oder zu deaktivieren (wenn false).
requestToSend-
Ein Boolean, der angibt, ob das Betriebssystem angewiesen werden soll, das "request to send"- oder "RTS"-Signal am seriellen Port entweder zu aktivieren (wenn true) oder zu deaktivieren (wenn false).
break-
Ein Boolean, der angibt, ob das Betriebssystem angewiesen werden soll, das "break"-Signal am seriellen Port entweder zu aktivieren (wenn true) oder zu deaktivieren (wenn false).
Rückgabewert
Ein Promise.
Ausnahmen
Das zurückgegebene Promise wird mit einer der folgenden Ausnahmen abgelehnt:
InvalidStateErrorDOMException-
Wenn
setSignals()aufgerufen wird, während der Port nicht geöffnet ist. Rufen SieSerialPort.open()auf, um den Port zuerst zu öffnen. NetworkErrorDOMException-
Wenn die Signale auf dem Gerät nicht gesetzt werden konnten.
Beispiele
Das "data terminal ready"-Signal aktivieren
Das folgende Beispiel aktiviert das DTR-Signal, wenn eine Verbindung hergestellt wird.
await port.open({ baudRate: 9600 });
await port.setSignals({ dataTerminalReady: true });
Spezifikationen
| Spezifikation |
|---|
| Web Serial API # dom-serialport-setsignals |