SerialPort

Konstruktor

Instanzen dieses Interfaces knnen durch Aufrufe von Methoden des Serial-Interfaces erhalten werden, daher hat es keinen eigenen Konstruktor.

Instanzeigenschaften

SerialPort.connected Schreibgeschtzt

Gibt einen booleschen Wert zurck, der anzeigt, ob der Port logisch mit dem Gert verbunden ist.

SerialPort.readable Schreibgeschtzt

Gibt einen ReadableStream zurck, um Daten vom mit dem Port verbundenen Gert zu empfangen.

SerialPort.writable Schreibgeschtzt

Gibt einen WritableStream zurck, um Daten an das mit dem Port verbundene Gert zu senden.

Instanzmethoden

SerialPort.forget()

Gibt ein Promise zurck, das aufgelst wird, wenn der Zugriff auf den seriellen Port widerrufen wird. Ein Aufruf dieser Methode "vergisst" das Gert, setzt alle zuvor gesetzten Berechtigungen zurck, sodass die aufrufende Seite nicht mehr mit dem Port kommunizieren kann.

SerialPort.getInfo()

Gibt ein Objekt zurck, das Identifikationsinformationen fr das ber den Port verfgbare Gert enthlt.

SerialPort.open()

Gibt ein Promise zurck, das aufgelst wird, wenn der Port geffnet wird. Standardmig wird der Port mit 8 Datenbits, 1 Stoppbit und ohne Parittsprfung geffnet.

SerialPort.setSignals()

Setzt Steuersignale am Port und gibt ein Promise zurck, das aufgelst wird, wenn sie gesetzt sind.

SerialPort.getSignals()

Gibt ein Promise zurck, das mit einem Objekt aufgelst wird, das den aktuellen Zustand der Steuersignale des Ports enthlt.

SerialPort.close()

Gibt ein Promise zurck, das aufgelst wird, wenn der Port geschlossen wird.

Ereignisse

connect

Wird ausgelst, wenn der Port mit dem Gert verbindet.

disconnect

Wird ausgelst, wenn der Port vom Gert trennt.

Beispiele

ffnen eines Ports

Bevor auf einem seriellen Port kommuniziert wird, muss er geffnet werden. Das ffnen des Ports ermglicht es der Seite, die notwendigen Parameter festzulegen, die steuern, wie Daten gesendet und empfangen werden. Entwickler sollten die Dokumentation fr das mit dem Port verbundene Gert konsultieren, um die geeigneten Parameter festzulegen.

await port.open({ baudRate: 9600 /* pick your baud rate */ });

Sobald das Promise, das von open() zurckgegeben wird, aufgelst ist, knnen die readable- und writable-Attribute aufgerufen werden, um die ReadableStream- und WritableStream-Instanzen zu erhalten, die zum Empfangen von Daten vom und Senden von Daten an das verbundene Gert verwendet werden.

Daten von einem Port lesen

Das folgende Beispiel zeigt, wie man Daten von einem Port liest. Die uere Schleife behandelt nicht-fatale Fehler und erstellt einen neuen Leser, bis ein fataler Fehler auftritt und readable zu null wird.

while (port.readable) {
  const reader = port.readable.getReader();
  try {
    while (true) {
      const { value, done } = await reader.read();
      if (done) {
        // |reader| has been canceled.
        break;
      }
      // Do something with |value|
    }
  } catch (error) {
    // Handle |error|
  } finally {
    reader.releaseLock();
  }
}

Daten zu einem Port schreiben

Das folgende Beispiel zeigt, wie man einen String zu einem Port schreibt. Ein TextEncoder konvertiert den String vor der bertragung in ein Uint8Array.

const encoder = new TextEncoder();
const writer = port.writable.getWriter();
await writer.write(encoder.encode("PING"));
writer.releaseLock();

Spezifikationen

Browser-Kompatibilitt