SerialPort: getSignals() 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 getSignals()-Methode des SerialPort-Interfaces gibt ein Promise zurück, das mit einem Objekt aufgelöst wird, welches den aktuellen Zustand der Steuerungssignale des Ports enthält.
Syntax
getSignals()
Parameter
Keine.
Rückgabewert
Gibt ein Promise zurück, das mit einem Objekt aufgelöst wird, welches die folgenden Mitglieder enthält:
clearToSend-
Ein boolean, der dem anderen Ende einer seriellen Verbindung anzeigt, dass es klar ist, Daten zu senden.
dataCarrierDetect-
Ein boolean, der das Steuersignal ein- oder ausschaltet, das benötigt wird, um über eine serielle Verbindung zu kommunizieren.
dataSetReady-
Ein boolean, der angibt, ob das Gerät bereit ist, Daten zu senden und zu empfangen.
ringIndicator-
Ein boolean, der anzeigt, ob ein Ringsignal über die serielle Verbindung gesendet werden soll.
Ausnahmen
Das zurückgegebene Promise wird mit einer der folgenden Ausnahmen abgelehnt:
InvalidStateErrorDOMException-
Wenn
getSignals()aufgerufen wird, während der Port nicht geöffnet ist. Rufen Sie zuerstSerialPort.open()auf, um den Port zu öffnen. NetworkErrorDOMException-
Wenn die Signale auf dem Gerät nicht gelesen werden konnten.
Beispiele
Überprüfen, ob das Gerät bereit ist, Daten zu senden und zu empfangen
Das folgende Beispiel liest die Steuersignale von einem offenen Port und überprüft die dataSetReady-Eigenschaft, um festzustellen, ob das angeschlossene Gerät bereit ist, zu kommunizieren.
const signals = await port.getSignals();
console.log(`Device ready: ${signals.dataSetReady}`);
Spezifikationen
| Spezifikation |
|---|
| Web Serial API # dom-serialport-getsignals |